MHSM Private Endpoint Connections - Get

Odwołanie

Usługa:: Key Vault

Wersja interfejsu API:: 2022-07-01

Pobiera określone połączenie prywatnego punktu końcowego skojarzone z zarządzaną pulą modułów HSM.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/managedHSMs/{name}/privateEndpointConnections/{privateEndpointConnectionName}?api-version=2022-07-01

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
name	path	True	string	Nazwa zarządzanej puli modułów HSM
privateEndpointConnectionName	path	True	string	Nazwa połączenia prywatnego punktu końcowego skojarzonego z zarządzaną pulą modułów HSM.
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zarządzaną pulę modułów HSM.
subscriptionId	path	True	string	Poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.
api-version	query	True	string	Wersja interfejsu API klienta.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	MHSMPrivateEndpointConnection	Pomyślnie zwrócono połączenie prywatnego punktu końcowego.
Other Status Codes	ManagedHsmError	Odpowiedź o błędzie opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

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

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

ManagedHsmGetPrivateEndpointConnection

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-group/providers/Microsoft.KeyVault/managedHSMs/sample-mhsm/privateEndpointConnections/sample-pec?api-version=2022-07-01

from azure.identity import DefaultAzureCredential
from azure.mgmt.keyvault import KeyVaultManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-keyvault
# USAGE
    python managed_hsm_get_private_endpoint_connection.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = KeyVaultManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000000",
    )

    response = client.mhsm_private_endpoint_connections.get(
        resource_group_name="sample-group",
        name="sample-mhsm",
        private_endpoint_connection_name="sample-pec",
    )
    print(response)


# x-ms-original-file: specification/keyvault/resource-manager/Microsoft.KeyVault/stable/2022-07-01/examples/ManagedHsm_getPrivateEndpointConnection.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Przykładowa odpowiedź

Kod stanu:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-group/providers/Microsoft.KeyVault/managedhsms/sample-mhsm/privateEndpointConnections/sample-pec",
  "name": "sample-pec",
  "type": "Microsoft.KeyVault/managedhsms/privateEndpointConnections",
  "etag": "",
  "properties": {
    "provisioningState": "Succeeded",
    "privateEndpoint": {
      "id": "/subscriptions/00000000-0000-0000-1234-000000000000/resourceGroups/sample-group/providers/Microsoft.Network/privateEndpoints/sample-pe"
    },
    "privateLinkServiceConnectionState": {
      "status": "Approved",
      "description": "This was automatically approved by user1234@contoso.com",
      "actionsRequired": "None"
    }
  }
}

Definicje

Nazwa	Opis
ActionsRequired	Komunikat wskazujący, czy zmiany dostawcy usług wymagają aktualizacji dla konsumenta.
Error	Błąd serwera.
identityType	Typ tożsamości, która utworzyła zasób magazynu kluczy.
ManagedHsmError	Wyjątek błędu.
ManagedHsmSku	Szczegóły jednostki SKU
ManagedHsmSkuFamily	Rodzina jednostek SKU zarządzanej puli modułów HSM
ManagedHsmSkuName	Jednostka SKU zarządzanej puli modułów HSM
MHSMPrivateEndpoint	Właściwości obiektu prywatnego punktu końcowego.
MHSMPrivateEndpointConnection	Zasób połączenia prywatnego punktu końcowego.
MHSMPrivateLinkServiceConnectionState	Obiekt reprezentujący stan zatwierdzenia połączenia łącza prywatnego.
PrivateEndpointConnectionProvisioningState	Stan aprowizacji połączenia prywatnego punktu końcowego.
PrivateEndpointServiceConnectionStatus	Wskazuje, czy połączenie zostało zatwierdzone, odrzucone lub usunięte przez właściciela magazynu kluczy.
SystemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu magazynu kluczy.

ActionsRequired

Komunikat wskazujący, czy zmiany dostawcy usług wymagają aktualizacji dla konsumenta.

Nazwa	Typ	Opis
None	string

Error

Błąd serwera.

Nazwa	Typ	Opis
code	string	Kod błędu.
innererror	Error	Wewnętrzny błąd zawiera bardziej szczegółowy kod błędu.
message	string	Komunikat o błędzie.

identityType

Typ tożsamości, która utworzyła zasób magazynu kluczy.

Nazwa	Typ	Opis
Application	string
Key	string
ManagedIdentity	string
User	string

ManagedHsmError

Wyjątek błędu.

Nazwa	Typ	Opis
error	Error	Błąd serwera.

ManagedHsmSku

Szczegóły jednostki SKU

Nazwa	Typ	Opis
family	ManagedHsmSkuFamily	Rodzina jednostek SKU zarządzanej puli modułów HSM
name	ManagedHsmSkuName	Jednostka SKU zarządzanej puli modułów HSM

ManagedHsmSkuFamily

Rodzina jednostek SKU zarządzanej puli modułów HSM

Nazwa	Typ	Opis
B	string

ManagedHsmSkuName

Jednostka SKU zarządzanej puli modułów HSM

Nazwa	Typ	Opis
Custom_B32	string
Custom_B6	string
Standard_B1	string