Udostępnij za pośrednictwem


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

Nazwa W Wymagane Typ Opis
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

Nazwa Typ Opis
location

string

Lokalizacja zasobu.

properties.armTemplateDisplayName

string

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

properties.deploymentProperties

EnvironmentDeploymentProperties

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

tags

object

Tagi zasobu.

Odpowiedzi

Nazwa Typ Opis
200 OK

DtlEnvironment

OK

201 Created

DtlEnvironment

Utworzone

Other Status Codes

CloudError

BadRequest

Zabezpieczenia

azure_auth

Przyznawanie niejawne OAuth2

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation Uzyskiwanie dostępu do platformy Microsoft Azure

Przykłady

Environments_CreateOrUpdate

Przykładowe żądanie

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}"
    }
  }
}

Przykładowa odpowiedź

{
  "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

Nazwa Opis
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.

Nazwa Typ Opis
name

string

Nazwa parametru szablonu.

value

string

Wartość parametru szablonu.

CloudError

Błąd żądania REST.

Nazwa Typ Opis
error

CloudErrorBody

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

CloudErrorBody

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

Nazwa Typ Opis
code

string

Kod błędu.

details

CloudErrorBody[]

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.

Nazwa Typ Opis
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

EnvironmentDeploymentProperties

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.

Nazwa Typ Opis
armTemplateId

string

Identyfikator szablonu usługi Azure Resource Manager.

parameters

ArmTemplateParameterProperties[]

Parametry szablonu usługi Azure Resource Manager.