Job Credentials - Create Or Update

Služba:

SQL Database

Verze rozhraní API:

2021-11-01

Vytvoří nebo aktualizuje přihlašovací údaje úlohy.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/jobAgents/{jobAgentName}/credentials/{credentialName}?api-version=2021-11-01

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
credentialName	path	True	string	Název přihlašovacích údajů.
jobAgentName	path	True	string	Název agenta úloh.
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.
serverName	path	True	string	Název serveru.
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.password	True	string	Heslo přihlašovacích údajů.
properties.username	True	string	Uživatelské jméno přihlašovacích údajů.

Odpovědi

Name	Typ	Description
200 OK	JobCredential	Přihlašovací údaje se úspěšně aktualizovaly.
201 Created	JobCredential	Přihlašovací údaje se úspěšně vytvořily.
Other Status Codes		Chybové odpovědi: *** 400 InvalidResourceRequestBody – prostředek nebo vlastnosti prostředku v textu požadavku jsou prázdné nebo neplatné. 400 InvalidJobCredentialUsername – neplatné uživatelské jméno přihlašovacích údajů. 403 JobCredentialPermissionError – Azure Resource Manager nemá oprávnění k používání nebo správě přihlašovacích údajů. 404 JobAgentNotFound – Zadaný agent úloh na zadaném logickém serveru neexistuje. 404 SubscriptionDoesNotHaveServer – Požadovaný server se nenašel. 404 ServerNotInSubscriptionResourceGroup – zadaný server v zadané skupině prostředků a předplatném neexistuje.

Příklady

Create or update a credential

Ukázkový požadavek

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/credentials/cred1?api-version=2021-11-01

{
  "properties": {
    "username": "myuser",
    "password": "<password>"
  }
}

Java

import com.azure.resourcemanager.sql.fluent.models.JobCredentialInner;

/**
 * Samples for JobCredentials CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/CreateOrUpdateJobCredential.json
     */
    /**
     * Sample code: Create or update a credential.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createOrUpdateACredential(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getJobCredentials().createOrUpdateWithResponse("group1", "server1",
            "agent1", "cred1", new JobCredentialInner().withUsername("myuser").withPassword("fakeTokenPlaceholder"),
            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

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/credentials/cred1",
  "name": "cred1",
  "type": "Microsoft.Sql/servers/jobAccounts/credentials",
  "properties": {
    "username": "myuser"
  }
}

Stavový kód:

201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/credentials/cred1",
  "name": "cred1",
  "type": "Microsoft.Sql/servers/jobAccounts/credentials",
  "properties": {
    "username": "myuser"
  }
}

Definice

JobCredential

Objekt

Uložené přihlašovací údaje, které může úloha použít k připojení k cílovým databázím.

Name	Typ	Description
id	string	ID prostředku.
name	string	Název prostředku.
properties.password	string	Heslo přihlašovacích údajů.
properties.username	string	Uživatelské jméno přihlašovacích údajů.
type	string	Typ prostředku.