Team

Team is a data type used to reference teams that exist in Port.

💡 Common team usage

The team property type can be used to reference any team that exists in Port, for example:

• The service owning team;
• The current on-call;
• The lead maintainers;
• etc.

In this live demo example, we can see the Team team property. 🎬

API definition

Basic

{
  "myTeamProp": {
    "title": "My team",
    "icon": "My icon",
    "description": "My team property",
    "type": "string",
    "format": "team",
    "default": "my-team"
  }
}

Array

{
  "myTeamArray": {
    "title": "My team array",
    "icon": "My icon",
    "description": "My team array",
    "type": "array",
    "items": {
      "type": "string",
      "format": "team"
    }
  }
}

Check out Port's API reference to learn more.

Terraform definition

Basic

resource "port_blueprint" "myBlueprint" {
  # ...blueprint properties
  properties = {
    string_props = {
      myTeamProp = {
        title    = "My team"
        required = false
        format   = "team"
      }
    }
  }
}

Array

resource "port_blueprint" "myBlueprint" {
  # ...blueprint properties
  properties = {
    array_props = {
      myTeamArray = {
        title    = "My team array"
        required = false
        type     = "array"
        string_items = {
          format = "user"
        }
      }
    }
  }
}

Pulumi definition

Python

"""A Python Pulumi program"""

import pulumi
from port_pulumi import Blueprint,BlueprintPropertiesArgs,BlueprintPropertiesStringPropsArgs

blueprint = Blueprint(
    "myBlueprint",
    identifier="myBlueprint",
    title="My Blueprint",
    properties=BlueprintPropertiesArgs(
        string_props={
            "myTeamProp": BlueprintPropertiesStringPropsArgs(
                title="My team",
                required=False,
                format="team",
            )
        }
    ),
    relations={}
)

TypeScript

import * as pulumi from "@pulumi/pulumi";
import * as port from "@port-labs/port";

export const blueprint = new port.Blueprint("myBlueprint", {
  identifier: "myBlueprint",
  title: "My Blueprint",
  properties: {
    stringProps: {
      myTeamProp: {
        title: "My team",
        required: false,
        format: "team",
      },
    },
  },
});

JavaScript

"use strict";
const pulumi = require("@pulumi/pulumi");
const port = require("@port-labs/port");

const entity = new port.Blueprint("myBlueprint", {
  title: "My Blueprint",
  identifier: "myBlueprint",
  properties: {
    stringProps: {
      myTeamProp: {
        title: "My team",
        required: false,
        format: "team",
      },
    },
  },
  relations: {},
});

exports.title = entity.title;

GO

package main

import (
	"github.com/port-labs/pulumi-port/sdk/go/port"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		blueprint, err := port.NewBlueprint(ctx, "myBlueprint", &port.BlueprintArgs{
			Identifier: pulumi.String("myBlueprint"),
			Title:      pulumi.String("My Blueprint"),
			Properties: port.BlueprintPropertiesArgs{
				StringProps: port.BlueprintPropertiesStringPropsMap{
					"myTeamProp": &port.BlueprintPropertyArgs{
                        Title:      pulumi.String("My team"),
                        Required:   pulumi.Bool(false),
                        Format:     pulumi.String("team"),
                    },
                },
			},
		})
		ctx.Export("blueprint", blueprint.Title)
		if err != nil {
			return err
		}
		return nil
	})
}