Job Credentials - Create Or Update

Service:

SQL Database

Version d'API:

2021-11-01

Crée ou met à jour les informations d’identification d’un travail.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
credentialName	path	True	string	Nom des informations d'identification.
jobAgentName	path	True	string	Nom de l’agent de travail.
resourceGroupName	path	True	string	Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager ou du portail.
serverName	path	True	string	Le nom du serveur
subscriptionId	path	True	string	L’ID d’abonnement d’un abonnement Azure.
api-version	query	True	string	Version de l’API à utiliser pour la requête.

Corps de la demande

Nom	Obligatoire	Type	Description
properties.password	True	string	Mot de passe des informations d’identification.
properties.username	True	string	Nom d’utilisateur des informations d’identification.

Réponses

Nom	Type	Description
200 OK	JobCredential	Mise à jour réussie des informations d’identification.
201 Created	JobCredential	Les informations d’identification ont été créées.
Other Status Codes		Réponses d’erreur : *** 400 InvalidResourceRequestBody : la ressource ou les propriétés de ressource dans le corps de la demande sont vides ou non valides. 400 InvalidJobCredentialUsername : nom d’identification non valide. 403 JobCredentialPermissionError : Azure Resource Manager n’est pas autorisé à utiliser ou à gérer les informations d’identification. 404 JobAgentNotFound : l’agent de travail spécifié n’existe pas dans le serveur logique spécifié. 404 SubscriptionDoesNotHaveServer : le serveur demandé est introuvable 404 ServerNotInSubscriptionResourceGroup : le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés.

Exemples

Create or update a credential

Exemple de requête

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

Exemple de réponse

Code d’état:

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

Code d’état:

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

Définitions

JobCredential

Object

Informations d’identification stockées qui peuvent être utilisées par un travail pour se connecter aux bases de données cibles.

Nom	Type	Description
id	string	ID de la ressource
name	string	Nom de la ressource.
properties.password	string	Mot de passe des informations d’identification.
properties.username	string	Nom d’utilisateur des informations d’identification.
type	string	Type de ressource.