Managed Instance Tde Certificates - Create

Reference

Služba:: SQL Database

Verze rozhraní API:: 2021-11-01

Vytvoří certifikát transparentního šifrování dat pro daný server.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/tdeCertificates?api-version=2021-11-01

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
managedInstanceName	path	True	string	Název spravované instance.
resourceGroupName	path	True	string	Název skupiny prostředků, která prostředek obsahuje. Tuto hodnotu můžete získat z rozhraní API Resource Manager Azure nebo z portálu.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Text požadavku

Name	Vyžadováno	Typ	Description
properties.privateBlob	True	string	Privátní objekt blob certifikátu kódovaný jako base64
properties.certPassword		string	Heslo certifikátu.

Odpovědi

Name	Typ	Description
200 OK		Certifikát transparentního šifrování dat se úspěšně vytvořil.
202 Accepted		Přijato
Other Status Codes		Chybové odpovědi: *** 400 MissingPrivateBlob – Privátní objekt blob chybí. 400 InvalidPrivateBlobOrPassword – zadaný neplatný privátní objekt blob nebo heslo. 400 PrivateBlobWithoutPrivateKey – zadaný objekt blob neobsahuje privátní klíč. 400 InvalidResourceRequestBody – prostředek nebo vlastnosti prostředku v textu požadavku jsou prázdné nebo neplatné. 404 SubscriptionDoesNotHaveServer – Požadovaný server se nenašel. 404 ServerNotInSubscriptionResourceGroup – zadaný server v zadané skupině prostředků a předplatném neexistuje. 404 ResourceNotFound – Požadovaný prostředek se nenašel. 404 OperationIdNotFound – operace s ID neexistuje. 409 OperationCancelled – operace byla zrušena uživatelem. 409 OperationInterrupted – Operaci s prostředkem nebylo možné dokončit, protože byla přerušena jinou operací se stejným prostředkem. 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad maximální počet požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 500 OperationTimedOut – časový limit operace vypršel a automaticky se vrátila zpět. Opakujte operaci. 503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.

Name

Typ

Description

200 OK

Certifikát transparentního šifrování dat se úspěšně vytvořil.

202 Accepted

Přijato

Other Status Codes

Chybové odpovědi: ***

400 MissingPrivateBlob – Privátní objekt blob chybí.
400 InvalidPrivateBlobOrPassword – zadaný neplatný privátní objekt blob nebo heslo.
400 PrivateBlobWithoutPrivateKey – zadaný objekt blob neobsahuje privátní klíč.
400 InvalidResourceRequestBody – prostředek nebo vlastnosti prostředku v textu požadavku jsou prázdné nebo neplatné.
404 SubscriptionDoesNotHaveServer – Požadovaný server se nenašel.
404 ServerNotInSubscriptionResourceGroup – zadaný server v zadané skupině prostředků a předplatném neexistuje.
404 ResourceNotFound – Požadovaný prostředek se nenašel.
404 OperationIdNotFound – operace s ID neexistuje.
409 OperationCancelled – operace byla zrušena uživatelem.
409 OperationInterrupted – Operaci s prostředkem nebylo možné dokončit, protože byla přerušena jinou operací se stejným prostředkem.
429 SubscriptionTooManyCreateUpdateRequests – požadavky nad maximální počet požadavků, které je možné zpracovat dostupnými prostředky.
429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.
500 OperationTimedOut – časový limit operace vypršel a automaticky se vrátila zpět. Opakujte operaci.
503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.

Příklady

Upload a TDE certificate

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/testtdecert/providers/Microsoft.Sql/managedInstances/testtdecert/tdeCertificates?api-version=2021-11-01

{
  "properties": {
    "privateBlob": "MIIXXXXXXXX"
  }
}


import com.azure.resourcemanager.sql.models.TdeCertificate;

/**
 * Samples for ManagedInstanceTdeCertificates Create.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedInstanceTdeCertificate.json
     */
    /**
     * Sample code: Upload a TDE certificate.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void uploadATDECertificate(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstanceTdeCertificates().create("testtdecert",
            "testtdecert", new TdeCertificate().withPrivateBlob("MIIXXXXXXXX"), com.azure.core.util.Context.NONE);
    }
}

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

Ukázková odpověď

Stavový kód:: 200

Stavový kód:: 202

Definice

TdeCertificate

Certifikát TDE, který je možné nahrát na server.

Name	Typ	Description
id	string	ID prostředku.
name	string	Název prostředku.
properties.certPassword	string	Heslo certifikátu.
properties.privateBlob	string	Privátní objekt blob certifikátu kódovaný jako base64
type	string	Typ prostředku.

Sdílet prostřednictvím