GetFolder - : Central de Documentação do Alibaba Cloud

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	GetFolder	Operação a ser executada. Defina o valor como GetFolder.
ProjectId	Long	Não	10000	ID do workspace do DataWorks. Acesse o console do DataWorks e vá até a página Workspace Management para obter esse identificador. Configure este parâmetro ou ProjectIdentifier para especificar o workspace do DataWorks alvo da operação.
ProjectIdentifier	String	Não	dw_project	Nome do workspace do DataWorks. Acesse o console do DataWorks e vá até a página Workspace Management para obter esse nome. Configure este parâmetro ou ProjectId para especificar o workspace do DataWorks alvo da operação.
FolderId	String	Não	273****	ID da pasta. Configure este parâmetro ou FolderPath. Para consultar o ID, chame a operação ListFolders.
FolderPath	String	Não	Workflow/1/MaxCompute/ods	Caminho da pasta. Configure este parâmetro ou FolderId. Para consultar o caminho, chame a operação ListFolders.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
HttpStatusCode	Integer	200	Código de status HTTP.
ErrorMessage	String	The connection does not exist.	Mensagem de erro.
RequestId	String	0000-ABCD-EFG****	ID da solicitação. Use este identificador para solucionar problemas.
ErrorCode	String	Invalid.Tenant.ConnectionNotExists	Código de erro.
Success	Boolean	true	Indica se a solicitação foi bem-sucedida.
Data	Object		Detalhes da pasta.
FolderPath	String	Workflow/1/MaxCompute/ods	Caminho da pasta.
FolderId	String	2735****	ID da pasta.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=GetFolder
&FolderId=273****
&FolderPath=Workflow/1/MaxCompute/ods
&RegionId=cn-zhangjiakou
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<RequestId>0000-ABCD-EFG****</RequestId>
<HttpStatusCode>200</HttpStatusCode>
<Data>
    <FolderPath>Workflow/1/MaxCompute/ods</FolderPath>
    <FolderId>2735****</FolderId>
</Data>
<ErrorCode>Invalid.Tenant.ConnectionNotExists</ErrorCode>
<ErrorMessage>The connection does not exist.</ErrorMessage>
<Success>true</Success>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "0000-ABCD-EFG****",
  "HttpStatusCode" : 200,
  "Data" : {
    "FolderPath" : "Workflow/1/MaxCompute/ods",
    "FolderId" : "2735****"
  },
  "ErrorCode" : "Invalid.Tenant.ConnectionNotExists",
  "ErrorMessage" : "The connection does not exist.",
  "Success" : true
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
429	Throttling.Api	The request for this resource has exceeded your available limit.	O número de solicitações para o recurso excedeu o limite permitido.
429	Throttling.System	The DataWorks system is busy. Try again later.	O sistema do DataWorks está ocupado. Tente novamente mais tarde.
429	Throttling.User	Your request is too frequent. Try again later.	Frequência de solicitações excessiva em curto período. Tente novamente mais tarde.
500	InternalError.System	An internal system error occurred. Try again later.	Ocorreu um erro interno do sistema. Tente novamente mais tarde.
500	InternalError.UserId.Missing	An internal system error occurred. Try again later.	Ocorreu um erro interno do sistema. Tente novamente mais tarde.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.