Job Credentials - Create Or Update

Служба:

SQL Database

Версия API:

2021-11-01

Создает или обновляет учетные данные задания.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
credentialName	path	True	string	Имя учетных данных.
jobAgentName	path	True	string	Имя агента задания.
resourceGroupName	path	True	string	Имя группы ресурсов, к которой относится ресурс. Это значение можно получить от API-интерфейса диспетчера ресурсов Azure или портала.
serverName	path	True	string	Имя сервера.
subscriptionId	path	True	string	Идентификатор подписки Azure.
api-version	query	True	string	Версия API для использования в запросе.

Текст запроса

Имя	Обязательно	Тип	Описание
properties.password	True	string	Пароль учетных данных.
properties.username	True	string	Имя пользователя учетных данных.

Ответы

Имя	Тип	Описание
200 OK	JobCredential	Учетные данные успешно обновлены.
201 Created	JobCredential	Учетные данные успешно созданы.
Other Status Codes		Ответы об ошибках: *** 400 InvalidResourceRequestBody — свойства ресурса или ресурса в тексте запроса пусты или недопустимы. 400 InvalidJobCredentialUsername — недопустимое имя пользователя учетных данных. 403 JobCredentialPermissionError — azure Resource Manager не имеет разрешения на использование учетных данных или управление ими. 404 JobAgentNotFound — указанный агент задания не существует на указанном логическом сервере. 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден. 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке.

Примеры

Create or update a credential

Образец запроса

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

Пример ответа

Код состояния:

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

Код состояния:

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

Определения

JobCredential

Сохраненные учетные данные, которые могут использоваться заданием для подключения к целевым базам данных.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.password	string	Пароль учетных данных.
properties.username	string	Имя пользователя учетных данных.
type	string	Тип ресурса.