Configuration d'autres paramètres de l'application

Vous pouvez configurer un certain nombre de paramètres d'application :

Ces paramètres peuvent être configurés dans le fichier App.config ou Web.config de l'application. Bien que vous puissiez également les configurer à l'aide de l' AWS SDK for .NET API, nous vous recommandons d'utiliser le .config fichier de l'application. Les deux approches sont décrites ici.

Pour plus d'informations sur l'utilisation de l'<aws>élément, comme décrit plus loin dans cette rubrique, consultez la section Référence des fichiers de configuration pour SDK for .NET.

AWSLogging

Configure comment SDK doit consigner les événements, le cas échéant. Par exemple, l'approche recommandée consiste à utiliser l'élément <logging>, élément enfant de l'élément <aws> :

<aws>
  <logging logTo="Log4Net"/>
</aws>

Autrement :

<add key="AWSLogging" value="log4net"/>

Les valeurs possibles sont :

Vous pouvez définir plusieurs valeurs pour l'attribut logTo, séparées par des virgules. L'exemple suivant définit la journalisation log4net et System.Diagnostics dans le fichier .config :

<logging logTo="Log4Net, SystemDiagnostics"/>

Autrement :

<add key="AWSLogging" value="log4net, SystemDiagnostics"/>

Vous pouvez également, à l'aide de l' AWS SDK for .NET API, combiner les valeurs de l'LoggingOptionsénumération et définir la propriété AWSConfigs.Logging :

AWSConfigs.Logging = LoggingOptions.Log4Net | LoggingOptions.SystemDiagnostics;

Les modifications apportées à ce paramètre ne prennent effet que pour les nouvelles instances AWS clientes.

AWSLogMétriques

Spécifie si SDK doit ou non journaliser les métriques de performance. Pour définir la configuration de journalisation des métriques dans le fichier .config, définissez la valeur de l'attribut logMetrics dans l'élément <logging>, élément enfant de l'élément <aws> :

<aws>
  <logging logMetrics="true"/>
</aws>

Sinon, définissez la clé AWSLogMetrics dans la section <appSettings> :

<add key="AWSLogMetrics" value="true">

Sinon, pour définir la journalisation des métriques avec l' AWS SDK for .NET API, définissez le AWSConfigs. LogMetricspropriété :

AWSConfigs.LogMetrics = true;

Ce paramètre configure la propriété LogMetrics par défaut pour tous les clients et toutes les configurations. Les modifications apportées à ce paramètre ne prennent effet que pour les nouvelles instances AWS clientes.

AWSRegion

Configure la AWS région par défaut pour les clients qui n'ont pas explicitement spécifié de région. Pour définir la région dans le fichier .config, l'approche recommandée consiste à définir la valeur de l'attribut region dans l'élément aws :

<aws region="us-west-2"/>

Sinon, définissez la clé AWSRegion dans la section <appSettings> :

<add key="AWSRegion" value="us-west-2"/>

Sinon, pour définir la région à l'aide de l' AWS SDK for .NET API, définissez le AWSConfigs. AWSRegionpropriété :

AWSConfigs.AWSRegion = "us-west-2";

Pour plus d'informations sur la création d'un AWS client pour une région spécifique, consultez la section Sélection de AWS région. Les modifications apportées à ce paramètre ne prennent effet que pour les nouvelles instances AWS clientes.

AWSResponseJournalisation

Configure quand SDK doit journaliser les réponses du service. Les valeurs possibles sont :

Pour définir la configuration de journalisation de service dans le fichier .config, l'approche recommandée consiste à définir la valeur de l'attribut logResponses dans l'élément <logging>, élément enfant de l'élément <aws> :

<aws>
  <logging logResponses="OnError"/>
</aws>

Vous pouvez également définir la clé de AWSResponsejournalisation dans la <appSettings> section :

<add key="AWSResponseLogging" value="OnError"/>

Sinon, pour configurer la journalisation des services avec l' AWS SDK for .NET API, définissez le AWSConfigs. ResponseLoggingpropriété à l'une des valeurs de l'ResponseLoggingOptionénumération :

AWSConfigs.ResponseLogging = ResponseLoggingOption.OnError;

Les modifications apportées à ce paramètre prennent effet immédiatement.

AWS.DynamoDBContext.TableNamePrefix

Configure la valeur par défaut de TableNamePrefix ; DynamoDBContext est utilisé si aucune configuration manuelle n'est effectuée.

Pour définir le préfixe du nom de table dans le fichier .config, l'approche recommandée consiste à définir la valeur de l'attribut tableNamePrefix dans l'élément <dynamoDBContext>, élément enfant de l'élément <dynamoDB>, lui-même élément enfant de l'élément <aws> :

<dynamoDBContext tableNamePrefix="Test-"/>

Sinon, définissez la clé AWS.DynamoDBContext.TableNamePrefix dans la section <appSettings> :

<add key="AWS.DynamoDBContext.TableNamePrefix" value="Test-"/>

Sinon, pour définir le préfixe du nom de table avec l' AWS SDK for .NET API, définissez la propriété AWSConfigs.Dynamo DBContext TableNamePrefix :

AWSConfigs.DynamoDBContextTableNamePrefix = "Test-";

Les modifications apportées à ce paramètre prennent effet uniquement pour les instances nouvellement construites de DynamoDBContextConfig et DynamoDBContext.

AWS.S3.UseSignatureVersion4

Configure si le client Amazon S3 doit ou non utiliser la signature version 4 pour signer avec les demandes.

Pour définir la signature de la version 4 pour Amazon S3 dans le .config fichier, l'approche recommandée consiste à définir l'useSignatureVersion4attribut de l'<s3>élément, qui est un élément enfant de l'<aws>élément :

<aws>
  <s3 useSignatureVersion4="true"/>
</aws>

Vous pouvez également définir la AWS.S3.UseSignatureVersion4 clé sur true dans la <appSettings> section :

<add key="AWS.S3.UseSignatureVersion4" value="true"/>

Sinon, pour définir la signature de la version 4 de la signature avec l' AWS SDK for .NET API, définissez la propriété AWSConfigs.S3 UseSignatureVersion 4 sur true :

AWSConfigs.S3UseSignatureVersion4 = true;

Par défaut, ce paramètre est false, mais Signature version 4 peut être utilisé par défaut dans certains cas ou avec certaines régions. Lorsque le paramètre est true, Signature version 4 est utilisé pour toutes les demandes. Les modifications apportées à ce paramètre ne prennent effet que pour les nouvelles instances du client Amazon S3.

AWSEndpointDéfinition

Configure si SDK doit utiliser un fichier de configuration personnalisé qui définit les régions et les points de terminaison.

Pour définir le fichier de définition de point de terminaison dans le fichier .config, nous vous recommandons de définir la valeur de l'attribut endpointDefinition dans l'élément <aws>.

<aws endpointDefinition="c:\config\endpoints.json"/>

Vous pouvez également définir la clé de AWSEndpointdéfinition dans la <appSettings> section :

<add key="AWSEndpointDefinition" value="c:\config\endpoints.json"/>

Sinon, pour définir le fichier de définition du point de terminaison avec l' AWS SDK for .NET API, définissez le AWSConfigs. EndpointDefinitionpropriété :

AWSConfigs.EndpointDefinition = @"c:\config\endpoints.json";

Si vous n'indiquez pas de nom de fichier, aucun fichier de configuration personnalisé ne sera utilisé. Les modifications apportées à ce paramètre ne prennent effet que pour les nouvelles instances AWS clientes. Le fichier endpoint.json est disponible sur. https://github.com/aws/aws-sdk-net/blob/master/sdk/src/Core/endpoints.json

AWS Points de terminaison générés par le service

Certains AWS services génèrent leurs propres points de terminaison au lieu de consommer un point de terminaison régional. Les clients de ces services utilisent une URL de service spécifique à chaque service et à vos ressources. Amazon CloudSearch et AWS IoT. Les exemples suivants illustrent comment obtenir les points de terminaison pour ces services.

Exemple de CloudSearch point de terminaison Amazon

Le CloudSearch client Amazon est utilisé pour accéder au service CloudSearch de configuration Amazon. Vous utilisez le service CloudSearch de configuration Amazon pour créer, configurer et gérer des domaines de recherche. Pour créer un domaine de recherche, créez un CreateDomainRequestobjet et indiquez la DomainName propriété. Créez un AmazonCloudSearchClientobjet à l'aide de l'objet de demande. Appelez la méthode CreateDomain. L'CreateDomainResponseobjet renvoyé par l'appel contient une DomainStatus propriété qui possède à la fois les SearchService points de terminaison DocService et. Créez un AmazonCloudSearchDomainConfigobjet et utilisez-le pour initialiser DocService les SearchService instances de la AmazonCloudSearchDomainClientclasse.

// Create domain and retrieve DocService and SearchService endpoints
DomainStatus domainStatus;
using (var searchClient = new AmazonCloudSearchClient())
{
    var request = new CreateDomainRequest
    {
        DomainName = "testdomain"
    };
    domainStatus = searchClient.CreateDomain(request).DomainStatus;
    Console.WriteLine(domainStatus.DomainName + " created");
}

// Test the DocService endpoint
var docServiceConfig = new AmazonCloudSearchDomainConfig
{
    ServiceURL = "https://" + domainStatus.DocService.Endpoint
};
using (var domainDocService = new AmazonCloudSearchDomainClient(docServiceConfig))
{
    Console.WriteLine("Amazon CloudSearchDomain DocService client instantiated using the DocService endpoint");
    Console.WriteLine("DocService endpoint = " + domainStatus.DocService.Endpoint);

    using (var docStream = new FileStream(@"C:\doc_source\XMLFile4.xml", FileMode.Open))
    {
        var upload = new UploadDocumentsRequest
        {
            ContentType = ContentType.ApplicationXml,
            Documents = docStream
        };
        domainDocService.UploadDocuments(upload);
    }
}

// Test the SearchService endpoint
var searchServiceConfig = new AmazonCloudSearchDomainConfig
{
    ServiceURL = "https://" + domainStatus.SearchService.Endpoint
};
using (var domainSearchService = new AmazonCloudSearchDomainClient(searchServiceConfig))
{
    Console.WriteLine("Amazon CloudSearchDomain SearchService client instantiated using the SearchService endpoint");
    Console.WriteLine("SearchService endpoint = " + domainStatus.SearchService.Endpoint);

    var searchReq = new SearchRequest
    {
        Query = "Gambardella",
        Sort = "_score desc",
        QueryParser = QueryParser.Simple
    };
    var searchResp = domainSearchService.Search(searchReq);
}

AWS IoT Exemple de points de terminaison

Pour obtenir le point de terminaison pour AWS IoT, créez un AmazonIoTClientobjet et appelez la DescribeEndPointméthode. L'DescribeEndPointResponseobjet renvoyé contient leEndpointAddress. Créez un AmazonIotDataConfigobjet, définissez la ServiceURL propriété et utilisez-le pour instancier la AmazonIotDataClientclasse.

string iotEndpointAddress;
using (var iotClient = new AmazonIoTClient())
{
    var endPointResponse = iotClient.DescribeEndpoint();
    iotEndpointAddress = endPointResponse.EndpointAddress;
}

var ioTdocServiceConfig = new AmazonIotDataConfig
{
    ServiceURL = "https://" + iotEndpointAddress
};
using (var dataClient = new AmazonIotDataClient(ioTdocServiceConfig))
{
    Console.WriteLine("AWS IoTData client instantiated using the endpoint from the IotClient");
}

<aws>
  <logging logTo="Log4Net"/>
</aws>

<add key="AWSLogging" value="log4net"/>

<logging logTo="Log4Net, SystemDiagnostics"/>

<add key="AWSLogging" value="log4net, SystemDiagnostics"/>

AWSConfigs.Logging = LoggingOptions.Log4Net | LoggingOptions.SystemDiagnostics;

<aws>
  <logging logMetrics="true"/>
</aws>

<add key="AWSLogMetrics" value="true">

AWSConfigs.LogMetrics = true;

<aws region="us-west-2"/>

<add key="AWSRegion" value="us-west-2"/>

AWSConfigs.AWSRegion = "us-west-2";

<aws>
  <logging logResponses="OnError"/>
</aws>

<add key="AWSResponseLogging" value="OnError"/>

AWSConfigs.ResponseLogging = ResponseLoggingOption.OnError;

<dynamoDBContext tableNamePrefix="Test-"/>

<add key="AWS.DynamoDBContext.TableNamePrefix" value="Test-"/>

AWSConfigs.DynamoDBContextTableNamePrefix = "Test-";

<aws>
  <s3 useSignatureVersion4="true"/>
</aws>

<add key="AWS.S3.UseSignatureVersion4" value="true"/>

AWSConfigs.S3UseSignatureVersion4 = true;

<aws endpointDefinition="c:\config\endpoints.json"/>

<add key="AWSEndpointDefinition" value="c:\config\endpoints.json"/>

AWSConfigs.EndpointDefinition = @"c:\config\endpoints.json";

// Create domain and retrieve DocService and SearchService endpoints
DomainStatus domainStatus;
using (var searchClient = new AmazonCloudSearchClient())
{
    var request = new CreateDomainRequest
    {
        DomainName = "testdomain"
    };
    domainStatus = searchClient.CreateDomain(request).DomainStatus;
    Console.WriteLine(domainStatus.DomainName + " created");
}

// Test the DocService endpoint
var docServiceConfig = new AmazonCloudSearchDomainConfig
{
    ServiceURL = "https://" + domainStatus.DocService.Endpoint
};
using (var domainDocService = new AmazonCloudSearchDomainClient(docServiceConfig))
{
    Console.WriteLine("Amazon CloudSearchDomain DocService client instantiated using the DocService endpoint");
    Console.WriteLine("DocService endpoint = " + domainStatus.DocService.Endpoint);

    using (var docStream = new FileStream(@"C:\doc_source\XMLFile4.xml", FileMode.Open))
    {
        var upload = new UploadDocumentsRequest
        {
            ContentType = ContentType.ApplicationXml,
            Documents = docStream
        };
        domainDocService.UploadDocuments(upload);
    }
}

// Test the SearchService endpoint
var searchServiceConfig = new AmazonCloudSearchDomainConfig
{
    ServiceURL = "https://" + domainStatus.SearchService.Endpoint
};
using (var domainSearchService = new AmazonCloudSearchDomainClient(searchServiceConfig))
{
    Console.WriteLine("Amazon CloudSearchDomain SearchService client instantiated using the SearchService endpoint");
    Console.WriteLine("SearchService endpoint = " + domainStatus.SearchService.Endpoint);

    var searchReq = new SearchRequest
    {
        Query = "Gambardella",
        Sort = "_score desc",
        QueryParser = QueryParser.Simple
    };
    var searchResp = domainSearchService.Search(searchReq);
}

string iotEndpointAddress;
using (var iotClient = new AmazonIoTClient())
{
    var endPointResponse = iotClient.DescribeEndpoint();
    iotEndpointAddress = endPointResponse.EndpointAddress;
}

var ioTdocServiceConfig = new AmazonIotDataConfig
{
    ServiceURL = "https://" + iotEndpointAddress
};
using (var dataClient = new AmazonIotDataClient(ioTdocServiceConfig))
{
    Console.WriteLine("AWS IoTData client instantiated using the endpoint from the IotClient");
}