Configurar um endpoint - Alibaba Cloud SDK: Central de Documentação do Alibaba Cloud

Configure endpoints no Alibaba Cloud Darabonba SDK para direcionar requisições de API ao domínio de service correto.

Nota

Um endpoint é o nome de domínio de uma API de service da Alibaba Cloud. Por exemplo, um endpoint do ECS pode ser ecs.cn-hangzhou.aliyuncs.com. Cada service possui seus próprios endpoints, que podem variar conforme a região.

Configurar um endpoint para envio de requisições de API

O Darabonba SDK oferece suporte a dois modos para especificar o endpoint da API, listados abaixo em ordem decrescente de prioridade:

Endpoint definido pelo usuário: especifique um endpoint exato ao inicializar um client do SDK. Consulte um endpoint acessando o

OpenAPI Explorer. Para obter mais informações sobre como consultar um endpoint no OpenAPI Explorer, consulte a seção "Consultar um endpoint" deste tópico.

use Darabonba\OpenApi\Models\Config;

$config = new Config([]);
// Omit the credential configuration.
$config->endpoint = "<endpoint>";

Endpoint concatenado: especifique um ID de região e o Darabonba SDK gerará um endpoint automaticamente. Esse modo funciona apenas se o SDK do service incluir um arquivo de dados de endpoint. Caso contrário, o erro config.endpoint can not be empty será retornado ao inicializar o client do SDK, sendo necessário especificar um endpoint exato. Para ver um exemplo de arquivo de dados de endpoint, consulte o ECS endpoint data file. Se a região de destino não constar no arquivo de dados, o endpoint será gerado no formato ${Code of the Alibaba Cloud service}.${Region ID}.aliyuncs.com.
```
use Darabonba\OpenApi\Models\Config;

$config = new Config([]);
// Omit the credential configuration.
$config->regionId = "<region-id>";
```
Configurar endpoints para upload de arquivos

O Darabonba SDK oferece suporte a dois endpoints para upload de arquivos.

Endpoint da plataforma aberta para autenticação. Configure um endpoint de VPC para obter informações de autenticação via VPC durante o upload de arquivos.

use Darabonba\OpenApi\Models\Config;
use GuzzleHttp\Psr7\Stream;
use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;
use AlibabaCloud\SDK\Facebody\V20191230\Facebody;
use AlibabaCloud\SDK\Facebody\V20191230\Facebody\Models\DetectBodyCountAdvanceRequest;

$config = new Config([]);
// Omit the credential configuration.
$config->regionId = "<region-id>";
$config->openPlatformEndpoint = "openplatform-vpc.cn-shanghai.aliyuncs.com";

$request = new DetectBodyCountAdvanceRequest();
$request->imageURLObject = new Stream(fopen("filepath"));

$runtime = new RuntimeOptions();
$client = new Facebody($config);

try {
    $response = $client->detectBodyCountAdvance($request, $runtime);
    var_dump($response);
} catch (TeaUnableRetryError $e) {
    var_dump($e->getMessage());
    var_dump($e->getErrorInfo());
    var_dump($e->getLastException());
    var_dump($e->getLastRequest());
}

Endpoint de upload de arquivos. Configure um endpoint interno para fazer uploads via rede interna ou VPC.

Consultar um endpoint

Você pode consultar um endpoint no OpenAPI Explorer.

Selecione um service da Alibaba Cloud na página inicial do OpenAPI Explorer. Por exemplo, selecione ECS.

Clique em na aba Regions.
Localize a região desejada e copie o endpoint correspondente.

Também é possível utilizar o método a seguir para consultar um endpoint:

Na aba API Debugging do OpenAPI Explorer, localize a operação de API que deseja chamar e defina o parâmetro RegionId. O OpenAPI Explorer gera automaticamente um código de exemplo do SDK que inclui o endpoint.

Configurar um endpoint para envio de requisições de API

Consultar um endpoint