Partager via


Projects - Update

Met à jour partiellement un projet.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevCenter/projects/{projectName}?api-version=2024-02-01

Paramètres URI

Nom Dans Obligatoire Type Description
projectName
path True

string

Nom du projet.

Modèle d’expression régulière: ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$

resourceGroupName
path True

string

Nom du groupe de ressources. Le nom ne respecte pas la casse.

subscriptionId
path True

string

ID de l’abonnement cible.

api-version
query True

string

Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom Type Description
identity

ManagedServiceIdentity

Propriétés d’identité managée

location

string

Emplacement géographique où réside la ressource

properties.catalogSettings

ProjectCatalogSettings

Paramètres à utiliser lors de l’association d’un projet à un catalogue.

properties.description

string

Description du projet.

properties.devCenterId

string

ID de ressource d’un DevCenter associé

properties.displayName

string

Nom d’affichage du projet.

properties.maxDevBoxesPerUser

integer

Lorsqu’il est spécifié, limite le nombre maximal de dev Box qu’un utilisateur peut créer dans tous les pools du projet. Cela n’aura aucun effet sur les dev Box existants en cas de réduction.

tags

object

Balises de ressource.

Réponses

Nom Type Description
200 OK

Project

Opération réussie

202 Accepted

Accepté. L’opération se termine de manière asynchrone.

En-têtes

Location: string

Other Status Codes

ErrorResponse

Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation Emprunter l’identité de votre compte d’utilisateur

Exemples

Projects_Update

Exemple de requête

PATCH https://management.azure.com/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/rg1/providers/Microsoft.DevCenter/projects/DevProject?api-version=2024-02-01

{
  "properties": {
    "description": "This is my first project.",
    "displayName": "Dev",
    "catalogSettings": {
      "catalogItemSyncTypes": [
        "EnvironmentDefinition"
      ]
    }
  },
  "tags": {
    "CostCenter": "R&D"
  }
}

Exemple de réponse

{
  "id": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/rg1/providers/Microsoft.DevCenter/projects/DevProject",
  "name": "myproject",
  "type": "Microsoft.DevCenter/projects",
  "properties": {
    "devCenterId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/rg1/providers/Microsoft.DevCenter/devcenters/Contoso",
    "devCenterUri": "https://4c7c8922-78e9-4928-aa6f-75ba59355371-contoso.centralus.devcenter.azure.com",
    "description": "This is my first project. Very exciting.",
    "displayName": "Dev",
    "catalogSettings": {
      "catalogItemSyncTypes": [
        "EnvironmentDefinition"
      ]
    },
    "provisioningState": "Succeeded"
  },
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-11-18T18:00:36.993Z",
    "lastModifiedBy": "user1",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-11-18T18:30:36.993Z"
  },
  "location": "centralus",
  "tags": {
    "displayName": "Dev",
    "CostCenter": "R&D"
  }
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.DevCenter/locations/CENTRALUS/operationStatuses/722e7bc4-60fa-4e6b-864f-d5bf12b9adc4?api-version=2024-02-01
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.DevCenter/locations/CENTRALUS/operationStatuses/722e7bc4-60fa-4e6b-864f-d5bf12b9adc4?api-version=2024-02-01

Définitions

Nom Description
CatalogItemType

Indique les types d’éléments de catalogue.

createdByType

Type d’identité qui a créé la ressource.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

ManagedServiceIdentity

Identité de service managée (identités attribuées par le système et/ou attribuées par l’utilisateur)

ManagedServiceIdentityType

Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).

Project

Représente une ressource de projet.

ProjectCatalogSettings

Paramètres à utiliser lors de l’association d’un projet à un catalogue.

ProjectUpdate

Propriétés du projet pour la mise à jour partielle. Les propriétés non fournies dans la demande de mise à jour ne seront pas modifiées.

ProvisioningState

État d’approvisionnement de la ressource.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

UserAssignedIdentity

Propriétés d’identité attribuées par l’utilisateur

CatalogItemType

Indique les types d’éléments de catalogue.

Nom Type Description
EnvironmentDefinition

string

createdByType

Type d’identité qui a créé la ressource.

Nom Type Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires

type

string

Type d’informations supplémentaires.

ErrorDetail

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d'erreur.

details

ErrorDetail[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

ManagedServiceIdentity

Identité de service managée (identités attribuées par le système et/ou attribuées par l’utilisateur)

Nom Type Description
principalId

string

ID de principal de service de l’identité affectée par le système. Cette propriété est fournie uniquement pour une identité affectée par le système.

tenantId

string

ID de locataire de l’identité affectée par le système. Cette propriété est fournie uniquement pour une identité affectée par le système.

type

ManagedServiceIdentityType

Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).

userAssignedIdentities

<string,  UserAssignedIdentity>

identités User-Assigned
Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM au format « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs du dictionnaire peuvent être des objets vides ({}) dans les requêtes.

ManagedServiceIdentityType

Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).

Nom Type Description
None

string

SystemAssigned

string

SystemAssigned, UserAssigned

string

UserAssigned

string

Project

Représente une ressource de projet.

Nom Type Description
id

string

ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »

identity

ManagedServiceIdentity

Propriétés d’identité managée

location

string

Emplacement géographique où réside la ressource

name

string

nom de la ressource.

properties.catalogSettings

ProjectCatalogSettings

Paramètres à utiliser lors de l’association d’un projet à un catalogue.

properties.description

string

Description du projet.

properties.devCenterId

string

ID de ressource d’un DevCenter associé

properties.devCenterUri

string

URI de la ressource du Centre de développement à laquelle ce projet est associé.

properties.displayName

string

Nom d’affichage du projet.

properties.maxDevBoxesPerUser

integer

Lorsqu’il est spécifié, limite le nombre maximal de dev Box qu’un utilisateur peut créer dans tous les pools du projet. Cela n’aura aucun effet sur les dev Box existants en cas de réduction.

properties.provisioningState

ProvisioningState

État d’approvisionnement de la ressource.

systemData

systemData

Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.

tags

object

Balises de ressource.

type

string

Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

ProjectCatalogSettings

Paramètres à utiliser lors de l’association d’un projet à un catalogue.

Nom Type Description
catalogItemSyncTypes

CatalogItemType[]

Indique les types d’éléments de catalogue qui peuvent être synchronisés.

ProjectUpdate

Propriétés du projet pour la mise à jour partielle. Les propriétés non fournies dans la demande de mise à jour ne seront pas modifiées.

Nom Type Description
identity

ManagedServiceIdentity

Propriétés d’identité managée

location

string

Emplacement géographique où réside la ressource

properties.catalogSettings

ProjectCatalogSettings

Paramètres à utiliser lors de l’association d’un projet à un catalogue.

properties.description

string

Description du projet.

properties.devCenterId

string

ID de ressource d’un DevCenter associé

properties.displayName

string

Nom d’affichage du projet.

properties.maxDevBoxesPerUser

integer

Lorsqu’il est spécifié, limite le nombre maximal de dev Box qu’un utilisateur peut créer dans tous les pools du projet. Cela n’aura aucun effet sur les dev Box existants en cas de réduction.

tags

object

Balises de ressource.

ProvisioningState

État d’approvisionnement de la ressource.

Nom Type Description
Accepted

string

Canceled

string

Created

string

Creating

string

Deleted

string

Deleting

string

Failed

string

MovingResources

string

NotSpecified

string

RolloutInProgress

string

Running

string

StorageProvisioningFailed

string

Succeeded

string

TransientFailure

string

Updated

string

Updating

string

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom Type Description
createdAt

string

Horodatage de la création de ressources (UTC).

createdBy

string

Identité qui a créé la ressource.

createdByType

createdByType

Type d’identité qui a créé la ressource.

lastModifiedAt

string

Horodatage de la dernière modification de la ressource (UTC)

lastModifiedBy

string

Identité qui a modifié la dernière ressource.

lastModifiedByType

createdByType

Type d’identité qui a modifié la dernière ressource.

UserAssignedIdentity

Propriétés d’identité attribuées par l’utilisateur

Nom Type Description
clientId

string

ID client de l’identité affectée.

principalId

string

ID principal de l’identité affectée.