Managed Hsms - Get

Referens

Tjänst:: Key Vault

API-version:: 2022-07-01

Hämtar den angivna hanterade HSM-poolen.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
name	path	True	string	Namnet på den hanterade HSM-poolen.
resourceGroupName	path	True	string	Namnet på resursgruppen som innehåller den hanterade HSM-poolen.
subscriptionId	path	True	string	Autentiseringsuppgifter för prenumeration som unikt identifierar Microsoft Azure-prenumeration. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop.
api-version	query	True	string	Klient-API-version.

Svar

Name	Typ	Description
200 OK	ManagedHsm	Hämtad hanterad HSM-pool
204 No Content		Begäran lyckades. Resursen finns inte.
Other Status Codes	ManagedHsmError	Felsvaret som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

Retrieve a managed HSM Pool

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/hsm-group/providers/Microsoft.KeyVault/managedHSMs/hsm1?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.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.managed_hsms.get(
        resource_group_name="hsm-group",
        name="hsm1",
    )
    print(response)


# x-ms-original-file: specification/keyvault/resource-manager/Microsoft.KeyVault/stable/2022-07-01/examples/ManagedHsm_Get.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

Exempelsvar

Statuskod:: 200

{
  "properties": {
    "tenantId": "00000000-0000-0000-0000-000000000000",
    "initialAdminObjectIds": [
      "00000000-0000-0000-0000-000000000000"
    ],
    "enableSoftDelete": true,
    "softDeleteRetentionInDays": 90,
    "enablePurgeProtection": false,
    "hsmUri": "https://westus.hsm1.managedhsm.azure.net",
    "provisioningState": "Succeeded",
    "statusMessage": "ManagedHsm is functional."
  },
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/hsm-group/providers/Microsoft.KeyVault/managedHSMs/hsm1",
  "name": "hsm1",
  "type": "Microsoft.KeyVault/managedHSMs",
  "location": "westus",
  "sku": {
    "family": "B",
    "name": "Standard_B1"
  },
  "tags": {
    "Dept": "hsm",
    "Environment": "dogfood"
  }
}

Statuskod:: 204

Definitioner

Name	Description
ActionsRequired	Ett meddelande som anger om ändringar i tjänstleverantören kräver uppdateringar på konsumenten.
ActivationStatus	Aktiveringsstatus
CreateMode	Skapa-läget för att ange om resursen skapas eller återställs från en borttagen resurs.
Error	Serverfelet.
identityType	Den typ av identitet som skapade nyckelvalvsresursen.
ManagedHsm	Resursinformation med utökad information.
ManagedHsmError	Felfelsfelet.
ManagedHsmProperties	Egenskaper för den hanterade HSM-poolen
ManagedHSMSecurityDomainProperties	Säkerhetsdomänegenskaperna för den hanterade hsmen.
ManagedHsmSku	SKU-information
ManagedHsmSkuFamily	SKU-familjen för den hanterade HSM-poolen
ManagedHsmSkuName	SKU för den hanterade HSM-poolen
MHSMIPRule	En regel som styr tillgängligheten för en hanterad hsm-pool från en specifik IP-adress eller ett ip-intervall.
MHSMNetworkRuleSet	En uppsättning regler som styr nätverkstillgängligheten för en hanterad hsm-pool.
MHSMPrivateEndpoint	Egenskaper för privata slutpunktsobjekt.
MHSMPrivateEndpointConnectionItem	Anslutningsobjekt för privat slutpunkt.
MHSMPrivateLinkServiceConnectionState	Ett objekt som representerar godkännandetillståndet för den privata länkanslutningen.
MHSMVirtualNetworkRule	En regel som styr tillgängligheten för en hanterad hsm-pool från ett specifikt virtuellt nätverk.
NetworkRuleAction	Standardåtgärden när ingen regel från ipRules och virtualNetworkRules matchar. Detta används endast när egenskapen bypass har utvärderats.
NetworkRuleBypassOptions	Talar om för vilken trafik som kan kringgå nätverksregler. Detta kan vara "AzureServices" eller "None". Om det inte anges är standardvärdet "AzureServices".
PrivateEndpointConnectionProvisioningState	Etableringstillstånd för den privata slutpunktsanslutningen.
PrivateEndpointServiceConnectionStatus	Anger om anslutningen har godkänts, avvisats eller tagits bort av nyckelvalvets ägare.
ProvisioningState	Etableringstillstånd.
PublicNetworkAccess	Kontrollera behörigheten till den hanterade HSM:en från offentliga nätverk.
SystemData	Metadata som rör skapande och senaste ändring av nyckelvalvsresursen.

ActionsRequired

Ett meddelande som anger om ändringar i tjänstleverantören kräver uppdateringar på konsumenten.

Name	Typ	Description
None	string

ActivationStatus

Aktiveringsstatus

Name	Typ	Description
Active	string	Den hanterade HSM-poolen är aktiv.
Failed	string	Det gick inte att aktivera managed hsm.
NotActivated	string	Den hanterade HSM-poolen har ännu inte aktiverats.
Unknown	string	Ett okänt fel uppstod när hanterad hsm aktiverades.

CreateMode

Skapa-läget för att ange om resursen skapas eller återställs från en borttagen resurs.

Name	Typ	Description
default	string	Skapa en ny hanterad HSM-pool. Det här är standardalternativet.
recover	string	Återställa den hanterade HSM-poolen från en mjukt borttagen resurs.

Error

Serverfelet.

Name	Typ	Description
code	string	Felkoden.
innererror	Error	Det inre felet innehåller en mer specifik felkod.
message	string	Felmeddelandet.

identityType

Den typ av identitet som skapade nyckelvalvsresursen.

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ManagedHsm

Resursinformation med utökad information.

Name	Typ	Description
id	string	Azure Resource Manager resurs-ID för den hanterade HSM-poolen.
location	string	Den Azure-plats som stöds där den hanterade HSM-poolen ska skapas.
name	string	Namnet på den hanterade HSM-poolen.
properties	ManagedHsmProperties	Egenskaper för den hanterade HSM
sku	ManagedHsmSku	SKU-information
systemData	SystemData	Metadata som rör skapande och senaste ändring av nyckelvalvsresursen.
tags	object	Resurstaggar
type	string	Resurstypen för den hanterade HSM-poolen.

ManagedHsmError

Felfelsfelet.

Name	Typ	Description
error	Error	Serverfelet.

ManagedHsmProperties

Egenskaper för den hanterade HSM-poolen

Name	Typ	Standardvärde	Description
createMode	CreateMode		Skapa-läget för att ange om resursen skapas eller återställs från en borttagen resurs.
enablePurgeProtection	boolean	True	Egenskap som anger om skydd mot rensning är aktiverat för den här hanterade HSM-poolen. Om du ställer in den här egenskapen på true aktiveras skydd mot rensning för den här hanterade HSM-poolen och dess innehåll . Endast den hanterade HSM-tjänsten kan initiera en hård, oåterkallelig borttagning. Det går inte att ångra aktiveringen av den här funktionen.
enableSoftDelete	boolean	True	Egenskap för att ange om funktionen "mjuk borttagning" är aktiverad för den här hanterade HSM-poolen. Mjuk borttagning är aktiverat som standard för alla hanterade HSM:er och är oföränderlig.
hsmUri	string		URI för den hanterade hsm-poolen för att utföra åtgärder på nycklar.
initialAdminObjectIds	string[]		Matris med inledande objekt-ID:t för administratörer för den här hanterade hsm-poolen.
networkAcls	MHSMNetworkRuleSet		Regler som styr åtkomsten till nyckelvalvet från specifika nätverksplatser.
privateEndpointConnections	MHSMPrivateEndpointConnectionItem[]		Lista över privata slutpunktsanslutningar som är associerade med den hanterade hsm-poolen.
provisioningState	ProvisioningState		Etableringstillstånd.
publicNetworkAccess	PublicNetworkAccess	Enabled	Kontrollera behörigheten till den hanterade HSM:en från offentliga nätverk.
scheduledPurgeDate	string		Det schemalagda rensningsdatumet i UTC.
securityDomainProperties	ManagedHSMSecurityDomainProperties		Egenskaper för hanterad HSM-säkerhetsdomän.
softDeleteRetentionInDays	integer	90	Mjukt borttagna datakvarhållningsdagar. När du tar bort en HSM eller en nyckel förblir den återställningsbar för den konfigurerade kvarhållningsperioden eller under en standardperiod på 90 dagar. Den accepterar värden mellan 7 och 90.
statusMessage	string		Meddelande om resursstatus.
tenantId	string		Azure Active Directory-klientorganisations-ID:t som ska användas för att autentisera begäranden till den hanterade HSM-poolen.

ManagedHSMSecurityDomainProperties

Säkerhetsdomänegenskaperna för den hanterade hsmen.

Name	Typ	Description
activationStatus	ActivationStatus	Aktiveringsstatus
activationStatusMessage	string	Meddelande om aktiveringsstatus.

ManagedHsmSku

SKU-information

Name	Typ	Description
family	ManagedHsmSkuFamily	SKU-familjen för den hanterade HSM-poolen
name	ManagedHsmSkuName	SKU för den hanterade HSM-poolen

ManagedHsmSkuFamily

SKU-familjen för den hanterade HSM-poolen

Name	Typ	Description
B	string

ManagedHsmSkuName

SKU för den hanterade HSM-poolen

Name	Typ	Description
Custom_B32	string
Custom_B6	string
Standard_B1	string

MHSMIPRule

En regel som styr tillgängligheten för en hanterad hsm-pool från en specifik IP-adress eller ett ip-intervall.

Name	Typ	Description
value	string	Ett IPv4-adressintervall i CIDR-notation, till exempel "124.56.78.91" (enkel IP-adress) eller "124.56.78.0/24" (alla adresser som börjar med 124.56.78).

MHSMNetworkRuleSet

En uppsättning regler som styr nätverkstillgängligheten för en hanterad hsm-pool.

Name	Typ	Description
bypass	NetworkRuleBypassOptions	Talar om för vilken trafik som kan kringgå nätverksregler. Detta kan vara "AzureServices" eller "None". Om det inte anges är standardvärdet "AzureServices".
defaultAction	NetworkRuleAction	Standardåtgärden när ingen regel från ipRules och virtualNetworkRules matchar. Detta används endast när egenskapen bypass har utvärderats.
ipRules	MHSMIPRule[]	Listan över IP-adressregler.
virtualNetworkRules	MHSMVirtualNetworkRule[]	Listan över regler för virtuella nätverk.

MHSMPrivateEndpoint

Egenskaper för privata slutpunktsobjekt.

Name	Typ	Description
id	string	Fullständig identifierare för den privata slutpunktsresursen.

MHSMPrivateEndpointConnectionItem

Anslutningsobjekt för privat slutpunkt.

Name	Typ	Description
etag	string	Ändras när det sker en ändring i tillståndet för den privata slutpunktsanslutningen.
id	string	ID för privat slutpunktsanslutning.
properties.privateEndpoint	MHSMPrivateEndpoint	Egenskaper för det privata slutpunktsobjektet.
properties.privateLinkServiceConnectionState	MHSMPrivateLinkServiceConnectionState	Godkännandetillstånd för den privata länkanslutningen.
properties.provisioningState	PrivateEndpointConnectionProvisioningState	Etableringstillstånd för den privata slutpunktsanslutningen.

MHSMPrivateLinkServiceConnectionState

Ett objekt som representerar godkännandetillståndet för den privata länkanslutningen.

Name	Typ	Description
actionsRequired	ActionsRequired	Ett meddelande som anger om ändringar på tjänstleverantören kräver uppdateringar på konsumenten.
description	string	Anledningen till godkännande eller avvisande.
status	PrivateEndpointServiceConnectionStatus	Anger om anslutningen har godkänts, avvisats eller tagits bort av nyckelvalvets ägare.

MHSMVirtualNetworkRule

En regel som styr tillgängligheten för en hanterad hsm-pool från ett specifikt virtuellt nätverk.

Name	Typ	Description
id	string	Fullständigt resurs-ID för ett vnet-undernät, till exempel "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1".

NetworkRuleAction

Standardåtgärden när ingen regel från ipRules och virtualNetworkRules matchar. Detta används endast när egenskapen bypass har utvärderats.

Name	Typ	Description
Allow	string
Deny	string

NetworkRuleBypassOptions

Talar om för vilken trafik som kan kringgå nätverksregler. Detta kan vara "AzureServices" eller "None". Om det inte anges är standardvärdet "AzureServices".

Name	Typ	Description
AzureServices	string
None	string

PrivateEndpointConnectionProvisioningState

Etableringstillstånd för den privata slutpunktsanslutningen.

Name	Typ	Description
Creating	string
Deleting	string
Disconnected	string
Failed	string
Succeeded	string
Updating	string

PrivateEndpointServiceConnectionStatus

Anger om anslutningen har godkänts, avvisats eller tagits bort av nyckelvalvets ägare.

Name	Typ	Description
Approved	string
Disconnected	string
Pending	string
Rejected	string

ProvisioningState

Etableringstillstånd.

Name	Typ	Description
Activated	string	Den hanterade HSM-poolen är redo för normal användning.
Deleting	string	Den hanterade HSM-poolen tas för närvarande bort.
Failed	string	Etableringen av den hanterade HSM-poolen misslyckades.
Provisioning	string	Den hanterade HSM-poolen etableras för närvarande.
Restoring	string	Den hanterade HSM-poolen återställs från fullständig HSM-säkerhetskopiering.
SecurityDomainRestore	string	Den hanterade HSM-poolen väntar på en återställningsåtgärd för säkerhetsdomäner.
Succeeded	string	Den hanterade HSM-poolen har etablerats fullständigt.
Updating	string	Den hanterade HSM-poolen uppdateras för närvarande.

PublicNetworkAccess

Kontrollera behörigheten till den hanterade HSM:en från offentliga nätverk.

Name	Typ	Description
Disabled	string
Enabled	string

SystemData

Metadata som rör skapande och senaste ändring av nyckelvalvsresursen.

Name	Typ	Description
createdAt	string	Tidsstämpeln för skapandet av nyckelvalvets resurs (UTC).
createdBy	string	Identiteten som skapade nyckelvalvsresursen.
createdByType	identityType	Den typ av identitet som skapade nyckelvalvsresursen.
lastModifiedAt	string	Tidsstämpeln för nyckelvalvsresursens senaste ändring (UTC).
lastModifiedBy	string	Identiteten som senast ändrade nyckelvalvsresursen.
lastModifiedByType	identityType	Den typ av identitet som senast ändrade nyckelvalvsresursen.

Dela via