Addresses - Update

Serviço:: Edge Hardware Center

Versão da API:: 2024-02-01

Atualize as propriedades de um endereço existente.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
addressName	path	True	string minLength: 3 maxLength: 24 pattern: ^[-\w\.]+$	O nome do endereço Recurso dentro do grupo de recursos especificado. Os nomes dos endereços devem ter entre 3 e 24 caracteres e usar apenas qualquer alfanumérico e sublinhado.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser um UUID.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Cabeçalho do Pedido

Name	Necessário	Tipo	Description
If-Match		string	Define a condição If-Match. O patch será executado somente se o ETag do trabalho no servidor corresponder a esse valor.

Corpo do Pedido

Name	Tipo	Description
properties.contactDetails	ContactDetails	Detalhes de contato para o endereço.
properties.shippingAddress	ShippingAddress	Detalhes de envio para o endereço.
tags	object	A lista de pares de valores de chave que descrevem o recurso. Essas tags podem ser usadas para visualizar e agrupar esse recurso (entre grupos de recursos).

Respostas

Name	Tipo	Description
200 OK	AddressResource	Operação do Azure concluída com êxito.
202 Accepted		Pedido de atualização de recursos aceito. Cabeçalhos Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Name

Tipo

Description

200 OK

AddressResource

Operação do Azure concluída com êxito.

202 Accepted

Pedido de atualização de recursos aceito.

Cabeçalhos

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

UpdateAddress

Pedido de amostra

HTTP

PATCH https://management.azure.com/subscriptions/eb5dc900-6186-49d8-b7d7-febd866fdc1d/resourceGroups/YourResourceGroupName/providers/Microsoft.EdgeOrder/addresses/TestAddressName2?api-version=2024-02-01

{
  "properties": {
    "contactDetails": {
      "contactName": "YYYY YYYY",
      "emailList": [
        "xxxx@xxxx.xxx"
      ],
      "phone": "0000000000",
      "phoneExtension": ""
    },
    "shippingAddress": {
      "addressType": "None",
      "city": "San Francisco",
      "companyName": "Microsoft",
      "country": "US",
      "postalCode": "94107",
      "stateOrProvince": "CA",
      "streetAddress1": "16 TOWNSEND ST",
      "streetAddress2": "UNIT 1"
    }
  },
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  }
}

Resposta da amostra

Código de estado:: 200

{
  "name": "TestAddressName2",
  "type": "Microsoft.EdgeOrder/addresses",
  "id": "/subscriptions/eb5dc900-6186-49d8-b7d7-febd866fdc1d/resourceGroups/YourResourceGroupName/providers/Microsoft.EdgeOrder/addresses/TestAddressName2",
  "location": "eastus",
  "properties": {
    "addressValidationStatus": "Valid",
    "contactDetails": {
      "contactName": "YYYY YYYY",
      "emailList": [
        "xxxx@xxxx.xxx"
      ],
      "phone": "0000000000",
      "phoneExtension": ""
    },
    "shippingAddress": {
      "addressType": "None",
      "city": "San Francisco",
      "companyName": "Microsoft",
      "country": "US",
      "postalCode": "94107",
      "stateOrProvince": "CA",
      "streetAddress1": "16 TOWNSEND ST",
      "streetAddress2": "UNIT 1"
    }
  },
  "systemData": {
    "createdAt": "0001-01-01T05:30:00+05:30",
    "lastModifiedAt": "0001-01-01T05:30:00+05:30"
  },
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  }
}

Código de estado:: 202

location: https://management.azure.com/subscriptions/eb5dc900-6186-49d8-b7d7-febd866fdc1d/providers/Microsoft.EdgeOrder/locations/westus/operationResults/operationid?api-version=2024-02-01

Definições

Name	Description
AddressClassification	Tipo de endereço com base no seu contexto de utilização.
AddressResource	Recurso de endereço.
AddressType	Tipo de endereço.
AddressUpdateParameter	Os parâmetros de atualização de endereço.
AddressValidationStatus	Status da validação de endereço.
ContactDetails	Detalhes de contacto.
createdByType	O tipo de identidade que criou o recurso.
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
ProvisioningState	Estado de aprovisionamento
ShippingAddress	Endereço de entrega onde o cliente deseja receber o dispositivo.
systemData	Metadados referentes à criação e última modificação do recurso.

AddressClassification

Enumeração

Tipo de endereço com base no seu contexto de utilização.

Valor	Description
Shipping	Endereço de envio da encomenda.
Site	Endereço do sítio Web.

AddressResource

Object

Recurso de endereço.

Name	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	A geolocalização onde o recurso vive
name	string	O nome do recurso
properties.addressClassification	AddressClassification	Tipo de endereço com base no seu contexto de utilização.
properties.addressValidationStatus	AddressValidationStatus	Status da validação de endereço.
properties.contactDetails	ContactDetails	Detalhes de contato para o endereço.
properties.provisioningState	ProvisioningState	Estado de aprovisionamento
properties.shippingAddress	ShippingAddress	Detalhes de envio para o endereço.
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
tags	object	Tags de recursos.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

AddressType

Enumeração

Tipo de endereço.

Valor	Description
None	Tipo de endereço desconhecido.
Residential	Endereço residencial.
Commercial	Endereço comercial.

AddressUpdateParameter

Object

Os parâmetros de atualização de endereço.

Name	Tipo	Description
properties.contactDetails	ContactDetails	Detalhes de contato para o endereço.
properties.shippingAddress	ShippingAddress	Detalhes de envio para o endereço.
tags	object	A lista de pares de valores de chave que descrevem o recurso. Essas tags podem ser usadas para visualizar e agrupar esse recurso (entre grupos de recursos).

AddressValidationStatus

Enumeração

Status da validação de endereço.

Valor	Description
Valid	O endereço fornecido é válido.
Invalid	O endereço fornecido é inválido ou não é suportado.
Ambiguous	O endereço fornecido é ambíguo, por favor, escolha um dos endereços alternativos devolvidos.

ContactDetails

Object

Detalhes de contacto.

Name	Tipo	Description
contactName	string	Nome de contacto da pessoa.
emailList	string[]	Lista de IDs de e-mail a serem notificados sobre o progresso do trabalho.
mobile	string	Número de telemóvel da pessoa de contacto.
phone	string	Número de telefone da pessoa de contacto.
phoneExtension	string	Número do ramal telefónico da pessoa de contacto.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

O erro de gerenciamento de recursos informações adicionais.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Object

O detalhe do erro.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Object

Resposta de erro

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

ProvisioningState

Enumeração

Estado de aprovisionamento

Valor	Description
Creating	Criação de estado.
Succeeded	Estado sucedido.
Failed	Estado com falha.
Canceled	Estado cancelado.

ShippingAddress

Object

Endereço de entrega onde o cliente deseja receber o dispositivo.

Name	Tipo	Description
addressType	AddressType	Tipo de endereço.
city	string	Nome da cidade.
companyName	string	Nome da empresa.
country	string	Nome do país.
postalCode	string	Código postal.
stateOrProvince	string	Nome do Estado ou Província.
streetAddress1	string	Endereço linha 1.
streetAddress2	string	Endereço linha 2.
streetAddress3	string	Endereço linha 3.
zipExtendedCode	string	CEP estendido.

systemData

Object

Metadados referentes à criação e última modificação do recurso.

Name	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

Partilhar via

Addresses - Update

Parâmetros do URI

Cabeçalho do Pedido

Corpo do Pedido

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

UpdateAddress

Pedido de amostra

Resposta da amostra

Definições

AddressClassification

AddressResource

AddressType

AddressUpdateParameter

AddressValidationStatus

ContactDetails

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ProvisioningState

ShippingAddress

systemData