Environments - Create Or Update

Utwórz lub zastąp istniejące środowisko. Wykonanie tej operacji może chwilę potrwać.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/users/{userName}/environments/{name}?api-version=2018-09-15

Parametry identyfikatora URI

Name In Required Type Description
labName
path True
  • string

Nazwa laboratorium.

name
path True
  • string

Nazwa środowiska.

resourceGroupName
path True
  • string

Nazwa grupy zasobów.

subscriptionId
path True
  • string

Identyfikator subskrypcji.

userName
path True
  • string

Nazwa profilu użytkownika.

api-version
query True
  • string

Wersja interfejsu API klienta.

Treść żądania

Name Type Description
location
  • string

Lokalizacja zasobu.

properties.armTemplateDisplayName
  • string

Nazwa wyświetlana szablonu usługi Azure Resource Manager, który wygenerował środowisko.

properties.deploymentProperties

Właściwości wdrożenia środowiska.

tags
  • object

Tagi zasobu.

Odpowiedzi

Name Type Description
200 OK

OK

201 Created

Utworzone

Other Status Codes

BadRequest

Zabezpieczenia

azure_auth

Przyznawanie niejawne OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation Microsoft Azure dostępu

Przykłady

Environments_CreateOrUpdate

Sample Request

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/resourceGroupName/providers/Microsoft.DevTestLab/labs/{labName}/users/@me/environments/{environmentName}?api-version=2018-09-15

{
  "properties": {
    "deploymentProperties": {
      "parameters": [],
      "armTemplateId": "/subscriptions/{subscriptionId}/resourceGroups/resourceGroupName/providers/Microsoft.DevTestLab/labs/{labName}/artifactSources/{artifactSourceName}/armTemplates/{armTemplateName}"
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}/users/{uniqueIdentifier}/environments/{environmentName}",
  "name": "{environmentName}",
  "type": "Microsoft.DevTestLab/labs/users/environments",
  "location": "{location}",
  "properties": {
    "deploymentProperties": {
      "armTemplateId": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}/artifactSources/{artifactSourceName}/armTemplates/{armTemplateName}"
    },
    "createdByUser": "user@contoso.com",
    "provisioningState": "Succeeded",
    "uniqueIdentifier": "{uniqueIdentifier}"
  },
  "tags": {
    "tagName1": "tagValue1"
  }
}
{
  "id": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}/users/{uniqueIdentifier}/environments/{environmentName}",
  "name": "{environmentName}",
  "type": "Microsoft.DevTestLab/labs/users/environments",
  "location": "{location}",
  "properties": {
    "deploymentProperties": {
      "armTemplateId": "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}/artifactSources/{artifactSourceName}/armTemplates/{armTemplateName}"
    },
    "createdByUser": "user@contoso.com",
    "provisioningState": "Creating",
    "uniqueIdentifier": "{uniqueIdentifier}"
  },
  "tags": {
    "tagName1": "tagValue1"
  }
}

Definicje

ArmTemplateParameterProperties

Właściwości parametru szablonu usługi Azure Resource Manager.

CloudError

Błąd żądania REST.

CloudErrorBody

Treść błędu z żądania REST.

DtlEnvironment

Środowisko, które jest zasadniczo wdrożeniem szablonu usługi ARM.

EnvironmentDeploymentProperties

Właściwości wdrożenia środowiska.

ArmTemplateParameterProperties

Właściwości parametru szablonu usługi Azure Resource Manager.

Name Type Description
name
  • string

Nazwa parametru szablonu.

value
  • string

Wartość parametru szablonu.

CloudError

Błąd żądania REST.

Name Type Description
error

Błąd chmury, który wystąpił

CloudErrorBody

Treść błędu z żądania REST.

Name Type Description
code
  • string

Kod błędu.

details

Błędy wewnętrzne.

message
  • string

Komunikat o błędzie.

target
  • string

Element docelowy błędu.

DtlEnvironment

Środowisko, które jest zasadniczo wdrożeniem szablonu usługi ARM.

Name Type Description
id
  • string

Identyfikator zasobu.

location
  • string

Lokalizacja zasobu.

name
  • string

Nazwa zasobu.

properties.armTemplateDisplayName
  • string

Nazwa wyświetlana szablonu usługi Azure Resource Manager, który wygenerował środowisko.

properties.createdByUser
  • string

Twórca środowiska.

properties.deploymentProperties

Właściwości wdrożenia środowiska.

properties.provisioningState
  • string

Stan aprowizacji zasobu.

properties.resourceGroupId
  • string

Identyfikator grupy zasobów zawierającej zasoby środowiska.

properties.uniqueIdentifier
  • string

Unikatowy niezmienny identyfikator zasobu (Guid).

tags
  • object

Tagi zasobu.

type
  • string

Typ zasobu.

EnvironmentDeploymentProperties

Właściwości wdrożenia środowiska.

Name Type Description
armTemplateId
  • string

Identyfikator szablonu usługi Azure Resource Manager.

parameters

Parametry szablonu usługi Azure Resource Manager.