Keyvault Osztály

Az Azure Machine Learning-munkaterülethez társított Azure Key Vault tárolt titkos kódokat kezeli.

Minden Azure Machine Learning-munkaterület rendelkezik egy társított Azure-Key Vault. A Keyvault osztály az Azure Key Vault egyszerűsített burkolója, amellyel titkos kulcsokat kezelhet a kulcstartóban, beleértve a titkos kulcsok beállítását, lekérését, törlését és listázását. A Keyvault osztály használatával titkos kulcsokat adhat át biztonságosan távoli futtatásokhoz anélkül, hogy bizalmas információkat tárt fel világos szövegben.

További információ: Titkos kódok használata a betanítási futtatásokban.

Keyvault-konstruktor osztály.

Öröklődés

builtins.object

Keyvault

Konstruktor

Keyvault(workspace)

Paraméterek

Name	Description
workspace Kötelező	Workspace A kulcstartóhoz társított Azure Machine Learning-munkaterület.
workspace Kötelező	Workspace A kulcstartóhoz társított Azure Machine Learning-munkaterület.

Megjegyzések

A helyi és távoli számításon futó elküldött futtatásokban a get_secret Futtatás példány metódusával lekérheti a titkos kód értékét Key Vault. Több titkos kód lekéréséhez használja a get_secrets Futtatás példány metódusát.

Ezek a futtatási módszerek egyszerű parancsikont adnak, mivel a Run példány ismeri a munkaterületet és a Keyvaultot, és közvetlenül beszerezheti a titkos kódot anélkül, hogy a munkaterületet és a Keyvaultot a távoli futtatáson belül kellene példányosítani.

Az alábbi példa bemutatja, hogyan érheti el a munkaterülethez társított alapértelmezett kulcstartót, és hogyan állíthat be egy titkos kulcsot.

   import uuid

   local_secret = os.environ.get("LOCAL_SECRET", default = str(uuid.uuid4())) # Use random UUID as a substitute for real secret.
   keyvault = ws.get_default_keyvault()
   keyvault.set_secret(name="secret-name", value = local_secret)

A teljes minta a következő forrásból érhető el: https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/manage-azureml-service/authentication-in-azureml/authentication-in-azureml.ipynb

Metódusok

delete_secret	Törölje a titkos kulcsot a megadott névvel.
delete_secrets	Törölje a munkaterülethez társított Azure-Key Vault titkos kulcsainak listáját.
get_secret	Adja vissza egy adott titkos kódnév titkos értékét.
get_secret_content_type	Adja vissza a titkos kód tartalomtípusát egy adott titkos kódnévhez.
get_secrets	Adja vissza a titkos nevek adott listájának titkos értékeit.
list_secrets	Adja vissza a munkaterülethez társított Azure-Key Vault titkos kódneveinek listáját. Ez a metódus nem adja vissza a titkos kód értékeit.
set_secret	Adjon hozzá egy titkos kulcsot a munkaterülethez társított Azure-Key Vault.
set_secrets	Adja hozzá a titkos kódok szótárát a munkaterülethez társított Azure-Key Vault.

delete_secret

Törölje a titkos kulcsot a megadott névvel.

delete_secret(name)

Paraméterek

Name	Description
name Kötelező	str A törölni kívánt titkos kód neve.

Válaszok

Típus	Description
None

delete_secrets

Törölje a munkaterülethez társított Azure-Key Vault titkos kulcsainak listáját.

delete_secrets(secrets)

Paraméterek

Name	Description
secrets_batch Kötelező	list[str] A törölni kívánt titkos kódok listája.
secrets Kötelező

Válaszok

Típus	Description
None

get_secret

Adja vissza egy adott titkos kódnév titkos értékét.

get_secret(name)

Paraméterek

Name	Description
name Kötelező	str A titkos kód neve, amely a értékét adja vissza.

Válaszok

Típus	Description
str	A megadott titkos kódnév titkos értéke.

get_secret_content_type

Adja vissza a titkos kód tartalomtípusát egy adott titkos kódnévhez.

get_secret_content_type(name)

Paraméterek

Name	Description
name Kötelező	str A titkos kód neve, amely a tartalomtípust adja vissza.

Válaszok

Típus	Description
str	Egy megadott titkos kódnév titkos tartalomtípusa.

get_secrets

Adja vissza a titkos nevek adott listájának titkos értékeit.

get_secrets(secrets)

Paraméterek

Name	Description
secrets Kötelező	list[str] Az értékek lekéréséhez használt titkos kódok listája.

Válaszok

Típus	Description
dict(str: str)	A talált és nem talált titkos kódok szótára.

list_secrets

Adja vissza a munkaterülethez társított Azure-Key Vault titkos kódneveinek listáját.

Ez a metódus nem adja vissza a titkos kód értékeit.

list_secrets()

Válaszok

Típus	Description
dict(str:str)	A(z) {name : "secretName"} formátumú titkos nevek szótárának listája

set_secret

Adjon hozzá egy titkos kulcsot a munkaterülethez társított Azure-Key Vault.

set_secret(name, value, content_type=KeyVaultContentType.not_provided)

Paraméterek

Name	Description
name Kötelező	str A hozzáadni kívánt titkos kód neve.
value Kötelező	<xref:azureml.core.azureml._restclient.models.KeyVaultContentType> A hozzáadni kívánt titkos kód értéke.
value Kötelező	A hozzáadni kívánt titkos kód tartalomtípusa.
content_type	alapértelmezett érték: KeyVaultContentType.not_provided

Válaszok

Típus	Description
None

set_secrets

Adja hozzá a titkos kódok szótárát a munkaterülethez társított Azure-Key Vault.

set_secrets(secrets_batch)

Paraméterek

Name	Description
secrets_batch Kötelező	dict(<xref:str:str>) A hozzáadni kívánt titkos kódok és értékek szótára.

Válaszok

Típus	Description
None