Job Credentials - Create Or Update

Tjänst:

SQL Database

API-version:

2021-11-01

Skapar eller uppdaterar en jobbautentiseringsuppgift.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
credentialName	path	True	string	Namnet på autentiseringsuppgifterna.
jobAgentName	path	True	string	Namnet på jobbagenten.
resourceGroupName	path	True	string	Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.
serverName	path	True	string	Namnet på servern.
subscriptionId	path	True	string	Det prenumerations-ID som identifierar en Azure-prenumeration.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Begärandetext

Name	Obligatorisk	Typ	Description
properties.password	True	string	Lösenordet för autentiseringsuppgifter.
properties.username	True	string	Användarnamnet för autentiseringsuppgifter.

Svar

Name	Typ	Description
200 OK	JobCredential	Autentiseringsuppgifterna har uppdaterats.
201 Created	JobCredential	Autentiseringsuppgifterna har skapats.
Other Status Codes		Felsvar: *** 400 InvalidResourceRequestBody – Resurs- eller resursegenskaperna i begärandetexten är tomma eller ogiltiga. 400 InvalidJobCredentialUsername – Ogiltigt användarnamn för autentiseringsuppgifter. 403 JobCredentialPermissionError – Azure Resource Manager har inte behörighet att använda eller hantera autentiseringsuppgifterna. 404 JobAgentNotFound – Den angivna jobbagenten finns inte på den angivna logiska servern. 404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen.

Exempel

Create or update a credential

Exempelbegäran

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

Exempelsvar

Statuskod:

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"
  }
}

Statuskod:

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"
  }
}

Definitioner

JobCredential

Objekt

En lagrad autentiseringsuppgift som kan användas av ett jobb för att ansluta till måldatabaser.

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.password	string	Lösenordet för autentiseringsuppgifter.
properties.username	string	Användarnamnet för autentiseringsuppgifter.
type	string	Resurstyp.