Files - Update

Serviço:

Data Migration

Versão da API:

2022-03-30-preview

Atualizar um arquivo
Esse método atualiza um arquivo existente.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.DataMigration/services/{serviceName}/projects/{projectName}/files/{fileName}?api-version=2022-03-30-preview

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
fileName	path	True	string	Nome do arquivo
groupName	path	True	string	Nome do grupo de recursos
projectName	path	True	string	Nome do projeto
serviceName	path	True	string	Nome do serviço
subscriptionId	path	True	string	ID da assinatura que identifica uma assinatura do Azure.
api-version	query	True	string	Versão da API

Corpo da solicitação

Nome	Tipo	Description
etag	string	Valor de marca de entidade forte HTTP. Isso será ignorado se enviado.
properties	ProjectFileProperties	Propriedades de arquivo personalizadas

Respostas

Nome	Tipo	Description
200 OK	ProjectFile	Recurso de arquivo atualizado
Other Status Codes	ApiError	Erro

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Files_Update

Solicitação de exemplo

HTTP

PATCH https://management.azure.com/subscriptions/fc04246f-04c5-437e-ac5e-206a19e7193f/resourceGroups/DmsSdkRg/providers/Microsoft.DataMigration/services/DmsSdkService/projects/DmsSdkProject/files/x114d023d8?api-version=2022-03-30-preview

{
  "properties": {
    "filePath": "DmsSdkFilePath/DmsSdkFile.sql"
  }
}

Python

from azure.identity import DefaultAzureCredential
from azure.mgmt.datamigration import DataMigrationManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-datamigration
# USAGE
    python files_update.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = DataMigrationManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="fc04246f-04c5-437e-ac5e-206a19e7193f",
    )

    response = client.files.update(
        group_name="DmsSdkRg",
        service_name="DmsSdkService",
        project_name="DmsSdkProject",
        file_name="x114d023d8",
        parameters={"properties": {"filePath": "DmsSdkFilePath/DmsSdkFile.sql"}},
    )
    print(response)


# x-ms-original-file: specification/datamigration/resource-manager/Microsoft.DataMigration/preview/2022-03-30-preview/examples/Files_Update.json
if __name__ == "__main__":
    main()

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

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.DataMigration.Models;
using Azure.ResourceManager.DataMigration;

// Generated from example definition: specification/datamigration/resource-manager/Microsoft.DataMigration/preview/2022-03-30-preview/examples/Files_Update.json
// this example is just showing the usage of "Files_Update" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ProjectFileResource created on azure
// for more information of creating ProjectFileResource, please refer to the document of ProjectFileResource
string subscriptionId = "fc04246f-04c5-437e-ac5e-206a19e7193f";
string groupName = "DmsSdkRg";
string serviceName = "DmsSdkService";
string projectName = "DmsSdkProject";
string fileName = "x114d023d8";
ResourceIdentifier projectFileResourceId = ProjectFileResource.CreateResourceIdentifier(subscriptionId, groupName, serviceName, projectName, fileName);
ProjectFileResource projectFile = client.GetProjectFileResource(projectFileResourceId);

// invoke the operation
ProjectFileData data = new ProjectFileData
{
    Properties = new ProjectFileProperties
    {
        FilePath = "DmsSdkFilePath/DmsSdkFile.sql",
    },
};
ProjectFileResource result = await projectFile.UpdateAsync(data);

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ProjectFileData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

Resposta de exemplo

Código de status:

200

{
  "properties": {
    "extension": "sql",
    "filePath": "DmsSdkFilePath/DmsSdkFile.sql"
  },
  "etag": "C2WE6C3yt2I0hunjpjzffY8LhTLqrJZHJ20gkuq2ZOA=",
  "id": "/subscriptions/fc04246f-04c5-437e-ac5e-206a19e7193f/resourceGroups/DmsSdkRg/providers/Microsoft.DataMigration/services/DmsSdkService/projects/DmsSdkProject/files/x114d023d8",
  "name": "x114d023d8",
  "type": "Microsoft.DataMigration/services/projects/files"
}

Definições

Nome	Description
ApiError	Informações de erro.
createdByType
ODataError	Informações de erro no formato OData.
ProjectFile	Um recurso de arquivo
ProjectFileProperties	Classe base para propriedades de arquivo.
SystemData

ApiError

Objeto

Informações de erro.

Nome	Tipo	Description
error	ODataError	Informações de erro no formato OData
systemData	SystemData	Metadados relativos à criação e última modificação do recurso.

createdByType

Enumeração

Valor	Description
Application
Key
ManagedIdentity
User

ODataError

Objeto

Informações de erro no formato OData.

Nome	Tipo	Description
code	string	A descrição legível pelo computador do erro, como 'InvalidRequest' ou 'InternalServerError'
details	ODataError[]	Erros internos que causaram esse erro
message	string	A descrição legível pelo humano do erro

ProjectFile

Objeto

Um recurso de arquivo

Nome	Tipo	Description
etag	string	Valor de marca de entidade forte HTTP. Isso será ignorado se enviado.
id	string	ID do recurso.
name	string	Nome do recurso.
properties	ProjectFileProperties	Propriedades de arquivo personalizadas
systemData	SystemData	Metadados relativos à criação e última modificação do recurso.
type	string	Tipo de recurso.

ProjectFileProperties

Objeto

Classe base para propriedades de arquivo.

Nome	Tipo	Description
extension	string	Extensão de arquivo opcional. Se enviado, ele não deve ter um período à esquerda e deve corresponder à extensão do filePath.
filePath	string	Caminho relativo desse recurso de arquivo. Essa propriedade pode ser definida ao criar ou atualizar o recurso de arquivo.
lastModified	string (date-time)	DateTime de modificação.
mediaType	string	Tipo de conteúdo do arquivo. Essa propriedade pode ser modificada para refletir o tipo de conteúdo do arquivo.
size	integer (int64)	Tamanho do arquivo.

SystemData

Objeto

Nome	Tipo	Description
createdAt	string (date-time)
createdBy	string
createdByType	createdByType
lastModifiedAt	string (date-time)
lastModifiedBy	string
lastModifiedByType	createdByType