Riferimento ai file di configurazione per AWS SDK per .NET

Puoi utilizzare un progetto App.config o un Web.config file .NET per specificare AWS impostazioni, come AWS credenziali, opzioni di registrazione, endpoint di AWS servizio e AWS regioni, nonché alcune impostazioni per AWS servizi come Amazon DynamoDB, Amazon e Amazon S3. EC2 Le informazioni seguenti descrivono come formattare correttamente un file App.config o Web.config per specificare questi tipi di impostazioni.

Dichiarazione di una sezione delle impostazioni AWS

AWS Le impostazioni vengono specificate in un Web.config file App.config or dall'interno dell'<aws>elemento. Prima di iniziare a utilizzare l'elemento <aws>, devi creare un elemento <section>, ossia un elemento figlio dell'elemento <configSections>, e impostare l'attributo name su aws e l'attributo type su Amazon.AWSSection, AWSSDK.Core, come nell'esempio seguente:

<?xml version="1.0"?>
<configuration>
  ...
  <configSections>
    <section name="aws" type="Amazon.AWSSection, AWSSDK.Core"/>
  </configSections>
  <aws>
    <!-- Add your desired AWS settings declarations here. -->
  </aws>
  ...
</configuration>

Visual Studio Editor non fornisce il completamento automatico del codice (IntelliSense) per l'<aws>elemento o i relativi elementi secondari.

Se serve assistenza per creare correttamente una versione formattata dell'elemento <aws>, chiama il metodo Amazon.AWSConfigs.GenerateConfigTemplate. Viene restituita una versione canonica dell'elemento <aws> sotto forma di stringa formattata che puoi adattare alle tue esigenze. Le sezioni seguenti descrivono gli attributi dell'elemento <aws> e i relativi elementi figlio.

Elementi consentiti

Di seguito è riportato un elenco delle relazioni logiche tra gli elementi consentiti in una sezione AWS delle impostazioni. Puoi generare la versione più recente di questo elenco chiamando il metodo Amazon.AWSConfigs.GenerateConfigTemplate, che fornisce una versione canonica dell'elemento <aws> sotto forma di stringa che puoi adattare alle tue esigenze.

<aws
  endpointDefinition="string value"
  region="string value"
  profileName="string value"
  profilesLocation="string value">
  <logging
    logTo="None, Log4Net, SystemDiagnostics"
    logResponses="Never | OnError | Always"
    logMetrics="true | false"
    logMetricsFormat="Standard | JSON"
    logMetricsCustomFormatter="NameSpace.Class, Assembly" />
  <dynamoDB
    conversionSchema="V1 | V2">
    <dynamoDBContext
      tableNamePrefix="string value">
      <tableAliases>
        <alias
          fromTable="string value"
          toTable="string value" />
      </tableAliases>
      <map
        type="NameSpace.Class, Assembly"
        targetTable="string value">
        <property
          name="string value"
          attribute="string value"
          ignore="true | false"
          version="true | false"
          converter="NameSpace.Class, Assembly" />
      </map>
    </dynamoDBContext>
  </dynamoDB>
  <s3
    useSignatureVersion4="true | false" />
  <ec2
    useSignatureVersion4="true | false" />
  <proxy
    host="string value"
    port="1234"
    username="string value"
    password="string value" />
</aws>

Riferimento per gli elementi elemento

Di seguito è riportato un elenco degli elementi consentiti in una sezione AWS delle impostazioni. Per ogni elemento sono elencati gli attributi e gli elementi padre-figlio consentiti.

alias

L'elemento <alias> rappresenta un singolo elemento in una raccolta di una o più mappature da from-table a to-table che specifica una tabella diversa rispetto a quella configurata per un tipo. Questo elemento viene mappato a un'istanza della classe Amazon.Util.TableAlias dalla proprietà Amazon.AWSConfigs.DynamoDBConfig.Context.TableAliases in AWS SDK per .NET. La ri-mappatura viene eseguita prima di applicare un prefisso al nome della tabella.

Questo elemento può includere gli attributi seguenti:

Il padre dell'elemento <alias> è l'elemento <tableAliases>.

L'elemento <alias> non contiene elementi figlio.

Di seguito è illustrato un esempio dell'elemento <alias> in uso:

<alias
  fromTable="Studio"
  toTable="Studios" />

aws

L'<aws>elemento rappresenta l'elemento più in alto in una sezione AWS delle impostazioni. Questo elemento può includere gli attributi seguenti:

L'elemento <aws> non ha elementi padre.

L'elemento <aws> può contenere i seguenti elementi figlio:

Di seguito è illustrato un esempio dell'elemento <aws> in uso:

<aws
  endpointDefinition="C:\Configs\endpoints.xml"
  region="us-west-2"
  profileName="development"
  profilesLocation="C:\Configs">
  <!-- ... -->
</aws>

dynamoDB

L'elemento <dynamoDB> rappresenta una raccolta di impostazioni per Amazon DynamoDB. Questo elemento può includere l'attributo conversionSchema, che rappresenta la versione da utilizzare per la conversione di oggetti .NET e DynamoDB. I valori consentiti includono V1 e V2. Questo attributo viene mappato alla classe Amazon.DynamoDBv2.DynamoDBEntryConversion in AWS SDK per .NET. Per ulteriori informazioni, vedi DynamoDB Series - Schemi di conversione.

Il padre dell'elemento <dynamoDB> è l'elemento <aws>.

L'elemento <dynamoDB> può contenere l'elemento figlio <dynamoDBContext>.

Di seguito è illustrato un esempio dell'elemento <dynamoDB> in uso:

<dynamoDB
  conversionSchema="V2">
  <!-- ... -->
</dynamoDB>

dinamo DBContext

L'elemento <dynamoDBContext> rappresenta una raccolta di impostazioni specifiche per il contesto di Amazon DynamoDB. Questo elemento può includere l'tableNamePrefixattributo, che rappresenta il prefisso del nome di tabella predefinito che il contesto DynamoDB utilizzerà se non è configurato manualmente. Questo attributo viene mappato alla proprietà Amazon.Util.DynamoDBContextConfig.TableNamePrefix dalla proprietà Amazon.AWSConfigs.DynamoDBConfig.Context.TableNamePrefix in AWS SDK per .NET. Per ulteriori informazioni, vedi Miglioramenti all'SDK DynamoDB.

Il padre dell'elemento <dynamoDBContext> è l'elemento <dynamoDB>.

L'elemento <dynamoDBContext> può contenere i seguenti elementi figlio:

Di seguito è illustrato un esempio dell'elemento <dynamoDBContext> in uso:

<dynamoDBContext
  tableNamePrefix="Test-">
  <!-- ... -->
</dynamoDBContext>

ec2

L'<ec2>elemento rappresenta una raccolta di EC2 impostazioni Amazon. Questo elemento può includere l'attributo useSignatureVersion4, che specifica se la firma della versione 4 della firma verrà utilizzata per tutte le richieste (true) o se la firma della versione 4 della firma non verrà utilizzata per tutte le richieste (false, l'impostazione predefinita). Questo attributo viene mappato alla proprietà Amazon.Util.EC2Config.UseSignatureVersion4 dalla proprietà Amazon.AWSConfigs.EC2Config.UseSignatureVersion4 in AWS SDK per .NET.

Il padre dell'elemento <ec2> è l'elemento.

L'elemento <ec2> non contiene elementi figlio.

Di seguito è illustrato un esempio dell'elemento <ec2> in uso:

<ec2
  useSignatureVersion4="true" />

logging

L'elemento <logging> rappresenta una raccolta di impostazioni per la registrazione delle risposte e la registrazione dei parametri delle prestazioni. Questo elemento può includere gli attributi seguenti:

Il padre dell'elemento <logging> è l'elemento <aws>.

L'elemento <logging> non contiene elementi figlio.

Di seguito è illustrato un esempio dell'elemento <logging> in uso:

<logging
  logTo="SystemDiagnostics"
  logResponses="OnError"
  logMetrics="true"
  logMetricsFormat="JSON"
  logMetricsCustomFormatter="MyLib.Util.MyMetricsFormatter, MyLib" />

map

L'<map>elemento rappresenta un singolo elemento in una raccolta di type-to-table mappature dai tipi.NET alle tabelle DynamoDB (esegue il mapping a un'istanza della TypeMapping classe dalla proprietà in). Amazon.AWSConfigs.DynamoDBConfig.Context.TypeMappings AWS SDK per .NET Per ulteriori informazioni, vedi Miglioramenti all'SDK DynamoDB.

Questo elemento può includere gli attributi seguenti:

Il padre dell'elemento <map> è l'elemento <dynamoDBContext>.

L'elemento <map> può includere una o più istanze dell'elemento figlio <property>.

Di seguito è illustrato un esempio dell'elemento <map> in uso:

<map
  type="SampleApp.Models.Movie, SampleDLL"
  targetTable="Movies">
  <!-- ... -->
</map>

property

L'elemento <property> rappresenta una proprietà di DynamoDB. (Questo elemento è mappato a un'istanza di Amazon.Util. PropertyConfig classe dal AddProperty metodo in AWS SDK per .NET) Per ulteriori informazioni, consulta Miglioramenti all'SDK di DynamoDB e agli attributi di DynamoDB.

Questo elemento può includere gli attributi seguenti:

Il padre dell'elemento <property> è l'elemento <map>.

L'elemento <property> non contiene elementi figlio.

Di seguito è illustrato un esempio dell'elemento <property> in uso:

<property
  name="Rating"
  converter="SampleApp.Models.RatingConverter, SampleDLL" />

proxy

L'elemento <proxy> rappresenta le impostazioni per la configurazione di un proxy da utilizzare con AWS SDK per .NET . Questo elemento può includere gli attributi seguenti:

Il padre dell'elemento <proxy> è l'elemento <aws>.

L'elemento <proxy> non contiene elementi figlio.

Di seguito è illustrato un esempio dell'elemento <proxy> in uso:

<proxy
  host="192.0.2.0"
  port="1234"
  username="My-Username-Here"
  password="My-Password-Here" />

s3

L'elemento <s3> rappresenta una raccolta di impostazioni di Amazon S3. Questo elemento può includere l'attributo useSignatureVersion4, che specifica se la firma della versione 4 della firma verrà utilizzata per tutte le richieste (true) o se la firma della versione 4 della firma non verrà utilizzata per tutte le richieste (false, l'impostazione predefinita). Questo attributo viene mappato alla proprietà Amazon.AWSConfigs.S3Config.UseSignatureVersion4 in AWS SDK per .NET.

Il padre dell'elemento <s3> è l'elemento <aws>.

L'elemento <s3> non contiene elementi figlio.

Di seguito è illustrato un esempio dell'elemento <s3> in uso:

<s3 useSignatureVersion4="true" />