Namespaces - Update

Servizio:: Relay

Versione API:: 2024-01-01

Crea o aggiorna uno spazio dei nomi. Dopo la creazione, il manifesto della risorsa dello spazio dei nomi non è modificabile. Questa operazione è idempotente.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Relay/namespaces/{namespaceName}?api-version=2024-01-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
namespaceName	path	True	string minLength: 6 maxLength: 50	Nome dello spazio dei nomi
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string minLength: 1	ID della sottoscrizione di destinazione.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Tipo	Descrizione
properties.privateEndpointConnections	PrivateEndpointConnection[]	Elenco delle connessioni endpoint private.
properties.publicNetworkAccess	PublicNetworkAccess	Determina se il traffico è consentito in rete pubblica. Per impostazione predefinita, è abilitata.
sku	Sku	SKU dello spazio dei nomi.
tags	object	Tag di risorsa.

Risposte

Nome	Tipo	Descrizione
200 OK	RelayNamespace	L'operazione di Azure è stata completata correttamente.
201 Created	RelayNamespace	Operazione di creazione della risorsa 'RelayNamespace' riuscita
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

RelayNameSpaceUpdate

Esempio di richiesta

HTTP

PATCH https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/RG-eg/providers/Microsoft.Relay/namespaces/example-RelayRelayNamespace-01?api-version=2024-01-01

{
  "tags": {
    "tag3": "value3",
    "tag4": "value4",
    "tag5": "value5",
    "tag6": "value6"
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "name": "example-RelayRelayNamespace-01",
  "type": "Microsoft.Relay/Namespaces",
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/RG-eg/providers/Microsoft.Relay/namespaces/example-RelayRelayNamespace-01",
  "location": "West US",
  "properties": {
    "metricId": "ffffffff-ffff-ffff-ffff-ffffffffffff:example-Relayrelaynamespace-01",
    "provisioningState": "Succeeded"
  },
  "tags": {
    "tag3": "value3",
    "tag4": "value4",
    "tag5": "value5",
    "tag6": "value6"
  }
}

Codice di stato:: 201

{
  "name": "example-RelayRelayNamespace-01",
  "type": "Microsoft.Relay/Namespaces",
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/RG-eg/providers/Microsoft.Relay/namespaces/example-RelayRelayNamespace-01",
  "location": "West US",
  "properties": {
    "metricId": "ffffffff-ffff-ffff-ffff-ffffffffffff:example-Relayrelaynamespace-01",
    "provisioningState": "Succeeded"
  },
  "tags": {
    "tag3": "value3",
    "tag4": "value4",
    "tag5": "value5",
    "tag6": "value6"
  }
}

Definizioni

Nome	Descrizione
ConnectionState	Informazioni su ConnectionState.
createdByType	Tipo di identità che ha creato la risorsa.
EndPointProvisioningState	Stato di provisioning della connessione endpoint privato.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
PrivateEndpoint	Informazioni privateEndpoint.
PrivateEndpointConnection	Proprietà di PrivateEndpointConnection.
PrivateLinkConnectionStatus	Stato della connessione.
PublicNetworkAccess	Determina se il traffico è consentito in rete pubblica. Per impostazione predefinita, è abilitata.
RelayNamespace	Descrizione di una risorsa dello spazio dei nomi.
RelayUpdateParameters	Descrizione di una risorsa dello spazio dei nomi.
Sku	SKU dello spazio dei nomi.
SkuName	Nome di questo SKU.
SkuTier	Livello di questo SKU.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

ConnectionState

Object

Informazioni su ConnectionState.

Nome	Tipo	Descrizione
description	string	Descrizione dello stato della connessione.
status	PrivateLinkConnectionStatus	Stato della connessione.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

EndPointProvisioningState

Enumerazione

Stato di provisioning della connessione endpoint privato.

Valore	Descrizione
Creating
Updating
Deleting
Succeeded
Canceled
Failed

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

PrivateEndpoint

Object

Informazioni privateEndpoint.

Nome	Tipo	Descrizione
id	string	Identificatore arm per endpoint privato.

PrivateEndpointConnection

Object

Proprietà di PrivateEndpointConnection.

Nome	Tipo	Descrizione
id	string	ID risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Posizione geografica in cui risiede la risorsa
name	string	Nome della risorsa
properties.privateEndpoint	PrivateEndpoint	Risorsa endpoint privato per questa connessione.
properties.privateLinkServiceConnectionState	ConnectionState	Dettagli sullo stato della connessione.
properties.provisioningState	EndPointProvisioningState	Stato di provisioning della connessione endpoint privato.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
type	string	Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

PrivateLinkConnectionStatus

Enumerazione

Stato della connessione.

Valore	Descrizione
Pending
Approved
Rejected
Disconnected

PublicNetworkAccess

Enumerazione

Determina se il traffico è consentito in rete pubblica. Per impostazione predefinita, è abilitata.

Valore	Descrizione
Enabled
Disabled
SecuredByPerimeter

RelayNamespace

Object

Descrizione di una risorsa dello spazio dei nomi.

Nome	Tipo	Valore predefinito	Descrizione
id	string		ID risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string		Posizione geografica in cui risiede la risorsa
name	string		Nome della risorsa
properties.createdAt	string (date-time)		Ora di creazione dello spazio dei nomi.
properties.metricId	string		Identificatore per le metriche di Azure Insights.
properties.privateEndpointConnections	PrivateEndpointConnection[]		Elenco delle connessioni endpoint private.
properties.provisioningState	string		Stato di provisioning dello spazio dei nomi.
properties.publicNetworkAccess	PublicNetworkAccess	Enabled	Determina se il traffico è consentito in rete pubblica. Per impostazione predefinita, è abilitata.
properties.serviceBusEndpoint	string		Endpoint che è possibile usare per eseguire operazioni del bus di servizio.
properties.status	string		Stato dello spazio dei nomi.
properties.updatedAt	string (date-time)		Ora in cui lo spazio dei nomi è stato aggiornato.
sku	Sku		SKU dello spazio dei nomi.
systemData	systemData		Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
tags	object		Tag di risorsa.
type	string		Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

RelayUpdateParameters

Object

Descrizione di una risorsa dello spazio dei nomi.

Nome	Tipo	Valore predefinito	Descrizione
id	string		ID risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string		Nome della risorsa
properties.createdAt	string (date-time)		Ora di creazione dello spazio dei nomi.
properties.metricId	string		Identificatore per le metriche di Azure Insights.
properties.privateEndpointConnections	PrivateEndpointConnection[]		Elenco delle connessioni endpoint private.
properties.provisioningState	string		Stato di provisioning dello spazio dei nomi.
properties.publicNetworkAccess	PublicNetworkAccess	Enabled	Determina se il traffico è consentito in rete pubblica. Per impostazione predefinita, è abilitata.
properties.serviceBusEndpoint	string		Endpoint che è possibile usare per eseguire operazioni del bus di servizio.
properties.status	string		Stato dello spazio dei nomi.
properties.updatedAt	string (date-time)		Ora in cui lo spazio dei nomi è stato aggiornato.
sku	Sku		SKU dello spazio dei nomi.
systemData	systemData		Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
tags	object		Tag di risorsa.
type	string		Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

Sku

Object

SKU dello spazio dei nomi.

Nome	Tipo	Descrizione
name	SkuName	Nome di questo SKU.
tier	SkuTier	Livello di questo SKU.

SkuName

Enumerazione

Nome di questo SKU.

Valore	Descrizione
Standard

SkuTier

Enumerazione

Livello di questo SKU.

Valore	Descrizione
Standard

systemData

Object

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

Condividi tramite

Namespaces - Update

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

RelayNameSpaceUpdate

Esempio di richiesta

Risposta di esempio

Definizioni

ConnectionState

createdByType

EndPointProvisioningState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

PrivateEndpoint

PrivateEndpointConnection

PrivateLinkConnectionStatus

PublicNetworkAccess

RelayNamespace

RelayUpdateParameters

Sku

SkuName

SkuTier

systemData