Kubernetes - Add

Service:

Distributed Task

Version d'API:

7.1-preview.1

POST https://dev.azure.com/{organization}/{project}/_apis/distributedtask/environments/{environmentId}/providers/kubernetes?api-version=7.1-preview.1

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
environmentId	path	True	integer int32
organization	path	True	string	Nom de l’organisation Azure DevOps.
project	path	True	string	ID de projet ou nom du projet
api-version	query	True	string	Version de l’API à utiliser. Cette valeur doit être définie sur « 7.1-preview.1 » pour utiliser cette version de l’API.

Corps de la demande

Nom	Type	Description
clusterName	string
name	string
namespace	string
tags	string[]	Étiquettes de la ressource kubernetes.

Réponses

Nom	Type	Description
200 OK	KubernetesResource	opération réussie

Sécurité

oauth2

Type: oauth2
Flux: accessCode
URL d’autorisation: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL du jeton: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Étendues

Nom	Description
vso.environment_manage	Permet de gérer l’environnement

Définitions

Nom	Description
EnvironmentReference
EnvironmentResourceType	Type de la ressource.
IdentityRef
KubernetesResource
KubernetesResourceCreateParameters
ReferenceLinks	Classe pour représenter une collection de liens de référence REST.

EnvironmentReference

Object

Nom	Type	Description
id	integer
name	string

EnvironmentResourceType

Enumeration

Type de la ressource.

Valeur	Description
generic	Type de ressource inconnu
kubernetes	Type de ressource Kubernetes
undefined
virtualMachine	Type de ressource de machine virtuelle

IdentityRef

Object

Nom	Type	Description
_links	ReferenceLinks	Ce champ contient zéro ou plus de liens intéressants sur le sujet du graphe. Ces liens peuvent être appelés pour obtenir des relations supplémentaires ou des informations plus détaillées sur ce sujet de graphique.
descriptor	string	Le descripteur est le principal moyen de référencer l’objet du graphe pendant l’exécution du système. Ce champ identifie de manière unique le même sujet de graphe pour les comptes et les organisations.
directoryAlias	string	Déconseillé : peut être récupéré en interrogeant l’utilisateur Graph référencé dans l’entrée « auto » du dictionnaire IdentityRef « _links »
displayName	string	Il s’agit du nom d’affichage non unique du sujet du graphique. Pour modifier ce champ, vous devez modifier sa valeur dans le fournisseur source.
id	string
imageUrl	string	Déconseillé : disponible dans l’entrée « avatar » du dictionnaire IdentityRef « _links »
inactive	boolean	Déconseillé : peut être récupéré en interrogeant l’état d’appartenance Graph référencé dans l’entrée « membershipState » du dictionnaire GraphUser « _links »
isAadIdentity	boolean	Déconseillé : peut être déduit du type d’objet du descripteur (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Déconseillé : peut être déduit du type d’objet du descripteur (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Déconseillé : non utilisé dans la plupart des implémentations préexistantes de ToIdentityRef
uniqueName	string	Déconseillé : utilisez Domain+PrincipalName à la place
url	string	Cette URL est l’itinéraire complet vers la ressource source de ce sujet de graphique.

KubernetesResource

Object

Nom	Type	Description
clusterName	string
createdBy	IdentityRef
createdOn	string
environmentReference	EnvironmentReference
id	integer
lastModifiedBy	IdentityRef
lastModifiedOn	string
name	string
namespace	string
serviceEndpointId	string
tags	string[]	Étiquettes de la ressource d’environnement.
type	EnvironmentResourceType	Type de ressource d’environnement

KubernetesResourceCreateParameters

Object

Nom	Type	Description
clusterName	string
name	string
namespace	string
tags	string[]	Étiquettes de la ressource kubernetes.

ReferenceLinks

Object

Classe pour représenter une collection de liens de référence REST.

Nom	Type	Description
links	object	Vue en lecture seule des liens. Étant donné que les liens de référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule.