Condividi tramite


Nsp Access Rules - Create Or Update

Crea o aggiorna una regola di accesso alla rete.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkSecurityPerimeters/{networkSecurityPerimeterName}/profiles/{profileName}/accessRules/{accessRuleName}?api-version=2023-07-01-preview

Parametri dell'URI

Nome In Necessario Tipo Descrizione
accessRuleName
path True

string

Nome della regola di accesso del provider di servizi di rete.

networkSecurityPerimeterName
path True

string

Nome del perimetro di sicurezza di rete.

profileName
path True

string

Nome del profilo NSP.

resourceGroupName
path True

string

Nome del gruppo di risorse.

subscriptionId
path True

string

Credenziali della sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.

api-version
query True

string

Versione API client.

Corpo della richiesta

Nome Tipo Descrizione
location

string

Percorso della risorsa.

name

string

Nome della regola di accesso univoca all'interno di un profilo. Questo nome può essere usato per accedere alla risorsa.

properties.addressPrefixes

string[]

Prefissi di indirizzi in ingresso (IPv4/IPv6)

properties.direction

AccessRuleDirection

Direzione che specifica se le regole di accesso sono in ingresso/in uscita.

properties.emailAddresses

string[]

Formato indirizzo di posta elettronica delle regole in uscita.

properties.fullyQualifiedDomainNames

string[]

Regole in uscita formato nome di dominio completo.

properties.phoneNumbers

string[]

Formato numero di telefono in uscita.

properties.subscriptions

SubscriptionId[]

Elenco degli ID sottoscrizione

tags

object

Tag di risorse.

Risposte

Nome Tipo Descrizione
200 OK

NspAccessRule

Aggiornato: la regola di accesso esistente viene aggiornata. Restituisce la risorsa.

201 Created

NspAccessRule

Create: restituisce la risorsa NspAccessRule creata.

Other Status Codes

CloudError

Risposta di errore che descrive perché l'operazione non è riuscita.

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

NspAccessRulePut

Esempio di richiesta

PUT https://management.azure.com/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp1/profiles/profile1/accessRules/accessRule1?api-version=2023-07-01-preview

{
  "properties": {
    "direction": "Inbound",
    "addressPrefixes": [
      "10.11.0.0/16",
      "10.10.1.0/24"
    ]
  }
}

Risposta di esempio

{
  "name": "accessRule1",
  "id": "/subscriptions/subId/resourceGroup/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp1/profiles/profile1/accessRules/accessRule1",
  "type": "Microsoft.Network/networkSecurityPerimeters/profiles/accessRules",
  "properties": {
    "provisioningState": "Succeeded",
    "direction": "Inbound",
    "addressPrefixes": [
      "10.11.0.0/16",
      "10.10.1.0/24"
    ],
    "fullyQualifiedDomainNames": [],
    "subscriptions": [],
    "networkSecurityPerimeters": [],
    "emailAddresses": [],
    "phoneNumbers": []
  }
}
{
  "name": "accessRule1",
  "id": "/subscriptions/subId/resourceGroup/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp1/profiles/profile1/accessRules/accessRule1",
  "type": "Microsoft.Network/networkSecurityPerimeters/profiles/accessRules",
  "properties": {
    "provisioningState": "Succeeded",
    "direction": "Inbound",
    "addressPrefixes": [
      "10.11.0.0/16",
      "10.10.1.0/24"
    ],
    "fullyQualifiedDomainNames": [],
    "subscriptions": [],
    "networkSecurityPerimeters": [],
    "emailAddresses": [],
    "phoneNumbers": []
  }
}

Definizioni

Nome Descrizione
AccessRuleDirection

Direzione che specifica se le regole di accesso sono in ingresso/in uscita.

CloudError

Risposta di errore dal servizio.

CloudErrorBody

Risposta di errore dal servizio.

NspAccessRule

Risorsa della regola di accesso NSP

nspProvisioningState

Stato di provisioning della risorsa di assegnazione dell'ambito.

PerimeterBasedAccessRule
SubscriptionId

AccessRuleDirection

Direzione che specifica se le regole di accesso sono in ingresso/in uscita.

Nome Tipo Descrizione
Inbound

string

Outbound

string

CloudError

Risposta di errore dal servizio.

Nome Tipo Descrizione
error

CloudErrorBody

Corpo dell'errore cloud.

CloudErrorBody

Risposta di errore dal servizio.

Nome Tipo Descrizione
code

string

Identificatore dell'errore. I codici sono invarianti e devono essere usati a livello di codice.

details

CloudErrorBody[]

Elenco di dettagli aggiuntivi sull'errore.

message

string

Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.

target

string

Destinazione dell'errore specifico. Ad esempio, il nome della proprietà in caso di errore.

NspAccessRule

Risorsa della regola di accesso NSP

Nome Tipo Descrizione
id

string

Identificatore della regola di accesso NSP.

location

string

Percorso della risorsa.

name

string

Nome della regola di accesso univoca all'interno di un profilo. Questo nome può essere usato per accedere alla risorsa.

properties.addressPrefixes

string[]

Prefissi di indirizzi in ingresso (IPv4/IPv6)

properties.direction

AccessRuleDirection

Direzione che specifica se le regole di accesso sono in ingresso/in uscita.

properties.emailAddresses

string[]

Formato indirizzo di posta elettronica delle regole in uscita.

properties.fullyQualifiedDomainNames

string[]

Regole in uscita formato nome di dominio completo.

properties.networkSecurityPerimeters

PerimeterBasedAccessRule[]

Regola specificata dall'ID perimetrale.

properties.phoneNumbers

string[]

Formato numero di telefono in uscita.

properties.provisioningState

nspProvisioningState

Stato di provisioning della risorsa di assegnazione dell'ambito.

properties.subscriptions

SubscriptionId[]

Elenco degli ID sottoscrizione

tags

object

Tag di risorse.

type

string

Tipo di risorsa.

nspProvisioningState

Stato di provisioning della risorsa di assegnazione dell'ambito.

Nome Tipo Descrizione
Accepted

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

PerimeterBasedAccessRule

Nome Tipo Descrizione
id

string

ID NSP nel formato ID ARM.

location

string

Posizione del provider di sicurezza di rete fornito.

perimeterGuid

string

Guid delle risorse del provider di sicurezza di rete fornito.

SubscriptionId

Nome Tipo Descrizione
id

string

ID sottoscrizione nel formato ID arm.