Versi 4 (V4) dari AWS SDK untuk .NET telah dirilis\$1

Untuk informasi tentang melanggar perubahan dan memigrasi aplikasi Anda, lihat [topik migrasi](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html).

 [https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html)

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Referensi File Konfigurasi untuk AWS SDK untuk .NET
<a name="net-dg-config-ref"></a>

**catatan**  
Informasi dalam topik ini khusus untuk proyek berdasarkan .NET Framework. `Web.config`File `App.config` dan tidak ada secara default dalam proyek berdasarkan .NET Core.

## Terbuka untuk melihat konten.NET Framework
<a name="w2aac11c29c11b5b1"></a>

Anda dapat menggunakan proyek `App.config` atau `Web.config` file .NET untuk menentukan AWS pengaturan, seperti AWS kredensional, opsi logging, titik akhir AWS layanan, dan AWS wilayah, serta beberapa pengaturan untuk AWS layanan, seperti Amazon DynamoDB, Amazon, dan Amazon S3. EC2 Informasi berikut menjelaskan cara memformat `Web.config` file `App.config` atau dengan benar untuk menentukan jenis pengaturan ini.

**catatan**  
Meskipun Anda dapat terus menggunakan `<appSettings>` elemen dalam `Web.config` file `App.config` atau untuk menentukan AWS pengaturan, kami sarankan Anda menggunakan `<aws>` elemen `<configSections>` dan seperti yang dijelaskan nanti dalam topik ini. Untuk informasi selengkapnya tentang `<appSettings>` elemen, lihat contoh `<appSettings>` elemen dalam [Mengkonfigurasi AWS SDK untuk .NET Aplikasi Anda](net-dg-config.md).

**catatan**  
Meskipun Anda dapat terus menggunakan properti [https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/TAWSConfigs.html](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/TAWSConfigs.html)kelas berikut dalam file kode untuk menentukan AWS pengaturan, properti berikut tidak digunakan lagi dan mungkin tidak didukung dalam rilis mendatang:  
 `DynamoDBContextTableNamePrefix` 
 `EC2UseSignatureVersion4` 
 `LoggingOptions` 
 `LogMetrics` 
 `ResponseLoggingOption` 
 `S3UseSignatureVersion4` 
Secara umum, kami menyarankan bahwa alih-alih menggunakan properti `AWSConfigs` kelas dalam file kode untuk menentukan AWS pengaturan, Anda harus menggunakan `<aws>` elemen `<configSections>` dan dalam `Web.config` file `App.config` atau untuk menentukan AWS pengaturan, seperti yang dijelaskan nanti dalam topik ini. Untuk informasi selengkapnya tentang properti sebelumnya, lihat contoh `AWSConfigs` kode di [Mengonfigurasi](net-dg-config.md) Aplikasi Anda. AWS SDK untuk .NET 

**Topics**
+ [Mendeklarasikan Bagian AWS Pengaturan](#net-dg-config-ref-declaring)
+ [Elemen yang Diizinkan](#net-dg-config-ref-elements)
+ [Referensi Elemen](#net-dg-config-ref-elements-ref)

### Mendeklarasikan Bagian AWS Pengaturan
<a name="net-dg-config-ref-declaring"></a>

Anda menentukan AWS pengaturan dalam `Web.config` file `App.config` atau dari dalam `<aws>` elemen. Sebelum Anda dapat mulai menggunakan `<aws>` elemen, Anda harus membuat `<section>` elemen (yang merupakan elemen anak dari `<configSections>` elemen) dan mengatur `name` atributnya ke `aws` dan `type` atributnya`Amazon.AWSSection, AWSSDK.Core`, seperti yang ditunjukkan pada contoh berikut:

```
<?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 tidak menyediakan penyelesaian kode otomatis (IntelliSense) untuk `<aws>` elemen atau elemen turunannya.

Untuk membantu Anda membuat versi `<aws>` elemen yang diformat dengan benar, panggil `Amazon.AWSConfigs.GenerateConfigTemplate` metode ini. Ini menghasilkan versi kanonik `<aws>` elemen sebagai string yang dicetak cantik, yang dapat Anda sesuaikan dengan kebutuhan Anda. Bagian berikut menjelaskan atribut `<aws>` elemen dan elemen anak.

### Elemen yang Diizinkan
<a name="net-dg-config-ref-elements"></a>

Berikut ini adalah daftar hubungan logis antara elemen yang diizinkan di bagian AWS pengaturan. Anda dapat menghasilkan versi terbaru dari daftar ini dengan memanggil `Amazon.AWSConfigs.GenerateConfigTemplate` metode, yang menghasilkan versi kanonik `<aws>` elemen sebagai string yang dapat Anda sesuaikan dengan kebutuhan Anda.

```
<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>
```

### Referensi Elemen
<a name="net-dg-config-ref-elements-ref"></a>

Berikut ini adalah daftar elemen yang diizinkan di bagian AWS pengaturan. Untuk setiap elemen, atribut yang diizinkan dan elemen induk-anak terdaftar.

**Topics**
+ [alias](#net-dg-config-ref-elements-alias)
+ [`aws`](#net-dg-config-ref-elements-aws)
+ [dynamoDB](#net-dg-config-ref-elements-dynamodb)
+ [dinamo DBContext](#net-dg-config-ref-elements-ddbcontext)
+ [ec2](#net-dg-config-ref-elements-ec2)
+ [pencatatan log](#net-dg-config-ref-elements-logging)
+ [map](#net-dg-config-ref-elements-map)
+ [properti](#net-dg-config-ref-elements-property)
+ [proxy](#net-dg-config-ref-elements-proxy)
+ [s3](#net-dg-config-ref-elements-s3)

#### alias
<a name="net-dg-config-ref-elements-alias"></a>

`<alias>`Elemen mewakili satu item dalam koleksi satu atau lebih pemetaan dari-tabel ke tabel yang menentukan tabel yang berbeda dari yang dikonfigurasi untuk tipe. Elemen ini memetakan ke instance `Amazon.Util.TableAlias` kelas dari `Amazon.AWSConfigs.DynamoDBConfig.Context.TableAliases` properti di AWS SDK untuk .NET. Pemetaan ulang dilakukan sebelum menerapkan awalan nama tabel.

Elemen ini dapat mencakup atribut berikut:

** `fromTable` **  
Bagian dari tabel dari pemetaan dari tabel ke tabel ke tabel. Atribut ini memetakan ke `Amazon.Util.TableAlias.FromTable` properti di AWS SDK untuk .NET.

** `toTable` **  
Bagian to-table dari pemetaan dari-tabel ke tabel ke tabel. Atribut ini memetakan ke `Amazon.Util.TableAlias.ToTable` properti di AWS SDK untuk .NET.

Induk `<alias>` elemen adalah `<tableAliases>` elemen.

`<alias>`Elemen tidak mengandung elemen anak.

Berikut ini adalah contoh `<alias>` elemen yang digunakan:

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

#### `aws`
<a name="net-dg-config-ref-elements-aws"></a>

`<aws>`Elemen mewakili elemen paling atas di bagian AWS pengaturan. Elemen ini dapat mencakup atribut berikut:

** `endpointDefinition` **  
Jalur absolut ke file konfigurasi khusus yang mendefinisikan AWS wilayah dan titik akhir yang akan digunakan. Atribut ini memetakan ke `Amazon.AWSConfigs.EndpointDefinition` properti di AWS SDK untuk .NET.

** `profileName` **  
Nama profil untuk AWS kredensi tersimpan yang akan digunakan untuk melakukan panggilan layanan. Atribut ini memetakan ke `Amazon.AWSConfigs.AWSProfileName` properti di AWS SDK untuk .NET.

** `profilesLocation` **  
Jalur absolut ke lokasi file kredensial yang dibagikan dengan yang lain. AWS SDKs Secara default, file kredensial disimpan dalam `.aws` direktori di direktori home pengguna saat ini. Atribut ini memetakan ke `Amazon.AWSConfigs.AWSProfilesLocation` properti di AWS SDK untuk .NET.

** `region` **  
ID AWS wilayah default untuk klien yang belum secara eksplisit menentukan wilayah. Atribut ini memetakan ke `Amazon.AWSConfigs.AWSRegion` properti di AWS SDK untuk .NET.

`<aws>`Elemen tidak memiliki elemen induk.

`<aws>`Elemen dapat mencakup elemen anak berikut:
+  `<dynamoDB>` 
+  `<ec2>` 
+  `<logging>` 
+  `<proxy>` 
+  `<s3>` 

Berikut ini adalah contoh `<aws>` elemen yang digunakan:

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

#### dynamoDB
<a name="net-dg-config-ref-elements-dynamodb"></a>

`<dynamoDB>`Elemen mewakili kumpulan pengaturan untuk Amazon DynamoDB. Elemen ini dapat menyertakan atribut *ConversionSchema*, yang mewakili versi yang akan digunakan untuk mengkonversi antara objek .NET dan DynamoDB. Nilai yang diizinkan termasuk V1 dan V2. Atribut ini memetakan ke `Amazon.DynamoDBv2.DynamoDBEntryConversion` kelas di AWS SDK untuk .NET. Untuk informasi selengkapnya, lihat [Seri DynamoDB - Skema](http://blogs.aws.amazon.com/net/post/Tx2TCOGWG7ARUH5/DynamoDB-Series-Conversion-Schemas) Konversi.

Induk `<dynamoDB>` elemen adalah `<aws>` elemen.

`<dynamoDB>`Elemen dapat mencakup elemen `<dynamoDBContext>` anak.

Berikut ini adalah contoh `<dynamoDB>` elemen yang digunakan:

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

#### dinamo DBContext
<a name="net-dg-config-ref-elements-ddbcontext"></a>

`<dynamoDBContext>`Elemen mewakili kumpulan pengaturan khusus konteks Amazon DynamoDB. Elemen ini dapat menyertakan *tableNamePrefix*atribut, yang mewakili awalan nama tabel default konteks DynamoDB akan digunakan jika tidak dikonfigurasi secara manual. Atribut ini memetakan ke `Amazon.Util.DynamoDBContextConfig.TableNamePrefix` `Amazon.AWSConfigs.DynamoDBConfig.Context.TableNamePrefix` properti dari properti di AWS SDK untuk .NET. Untuk informasi selengkapnya, lihat [Penyempurnaan pada DynamoDB](http://blogs.aws.amazon.com/net/post/Tx2C4MHH2H0SA5W/Enhancements-to-the-DynamoDB-SDK) SDK.

Induk `<dynamoDBContext>` elemen adalah `<dynamoDB>` elemen.

`<dynamoDBContext>`Elemen dapat mencakup elemen anak berikut:
+  `<alias>`(satu atau lebih contoh)
+  `<map>`(satu atau lebih contoh)

Berikut ini adalah contoh `<dynamoDBContext>` elemen yang digunakan:

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

#### ec2
<a name="net-dg-config-ref-elements-ec2"></a>

`<ec2>`Elemen mewakili kumpulan EC2 pengaturan Amazon. Elemen ini dapat mencakup atribut *useSignatureVersion4*, yang menentukan apakah tanda tangan versi 4 penandatanganan akan digunakan untuk semua permintaan (true) atau apakah tanda tangan versi 4 penandatanganan tidak akan digunakan untuk semua permintaan (false, default). Atribut ini memetakan ke `Amazon.Util.EC2Config.UseSignatureVersion4` `Amazon.AWSConfigs.EC2Config.UseSignatureVersion4` properti dari properti di AWS SDK untuk .NET.

Induk `<ec2>` elemen adalah elemen.

`<ec2>`Elemen tidak mengandung elemen anak.

Berikut ini adalah contoh `<ec2>` elemen yang digunakan:

```
<ec2
  useSignatureVersion4="true" />
```

#### pencatatan log
<a name="net-dg-config-ref-elements-logging"></a>

`<logging>`Elemen mewakili kumpulan pengaturan untuk pencatatan respons dan pencatatan metrik kinerja. Elemen ini dapat mencakup atribut berikut:

** `logMetrics` **  
Apakah metrik kinerja akan dicatat untuk semua klien dan konfigurasi (true); jika tidak, false. Atribut ini memetakan ke `Amazon.Util.LoggingConfig.LogMetrics` `Amazon.AWSConfigs.LoggingConfig.LogMetrics` properti dari properti di AWS SDK untuk .NET.

** `logMetricsCustomFormatter` **  
Jenis data dan nama rakitan formatter kustom untuk metrik logging. Atribut ini memetakan ke `Amazon.Util.LoggingConfig.LogMetricsCustomFormatter` `Amazon.AWSConfigs.LoggingConfig.LogMetricsCustomFormatter` properti dari properti di AWS SDK untuk .NET.

** `logMetricsFormat` **  
Format di mana metrik logging disajikan (peta ke `Amazon.Util.LoggingConfig.LogMetricsFormat` properti dari `Amazon.AWSConfigs.LoggingConfig.LogMetricsFormat` properti di AWS SDK untuk .NET).  
Nilai yang diizinkan meliputi:    
** `JSON` **  
Gunakan format JSON.  
** `Standard` **  
Gunakan format default.

** `logResponses` **  
Kapan harus mencatat tanggapan layanan (peta ke `Amazon.Util.LoggingConfig.LogResponses` properti dari `Amazon.AWSConfigs.LoggingConfig.LogResponses` properti di AWS SDK untuk .NET).  
Nilai yang diizinkan meliputi:    
** `Always` **  
Selalu log tanggapan layanan.  
** `Never` **  
Jangan pernah mencatat tanggapan layanan.  
** `OnError` **  
Hanya log tanggapan layanan ketika ada kesalahan.

** `logTo` **  
Tempat masuk (peta ke `LogTo` properti dari `Amazon.AWSConfigs.LoggingConfig.LogTo` properti di AWS SDK untuk .NET).  
Nilai yang diizinkan mencakup satu atau lebih dari:    
** `Log4Net` **  
Masuk ke log4net.  
** `None` **  
Nonaktifkan logging.  
** `SystemDiagnostics` **  
Masuk ke System.Diagnostics.

Induk `<logging>` elemen adalah `<aws>` elemen.

`<logging>`Elemen tidak mengandung elemen anak.

Berikut ini adalah contoh `<logging>` elemen yang digunakan:

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

#### map
<a name="net-dg-config-ref-elements-map"></a>

`<map>`Elemen mewakili satu item dalam koleksi type-to-table pemetaan dari tipe.NET ke tabel DynamoDB (peta ke instance `TypeMapping` kelas dari properti di). `Amazon.AWSConfigs.DynamoDBConfig.Context.TypeMappings` AWS SDK untuk .NET Untuk informasi selengkapnya, lihat [Penyempurnaan pada DynamoDB](http://blogs.aws.amazon.com/net/post/Tx2C4MHH2H0SA5W/Enhancements-to-the-DynamoDB-SDK) SDK.

Elemen ini dapat mencakup atribut berikut:

** `targetTable` **  
Tabel DynamoDB tempat pemetaan berlaku. Atribut ini memetakan ke `Amazon.Util.TypeMapping.TargetTable` properti di AWS SDK untuk .NET.

** `type` **  
Jenis dan nama perakitan yang diterapkan pemetaan. Atribut ini memetakan ke `Amazon.Util.TypeMapping.Type` properti di AWS SDK untuk .NET.

Induk `<map>` elemen adalah `<dynamoDBContext>` elemen.

`<map>`Elemen dapat mencakup satu atau lebih contoh elemen `<property>` anak.

Berikut ini adalah contoh `<map>` elemen yang digunakan:

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

#### properti
<a name="net-dg-config-ref-elements-property"></a>

`<property>`Elemen merupakan properti DynamoDB. (Elemen ini memetakan ke instance Amazon.Util. PropertyConfig [class dari `AddProperty` metode dalam AWS SDK untuk .NET) Untuk informasi selengkapnya, lihat [Penyempurnaan ke DynamoDB SDK dan DynamoDB Attribut](http://blogs.aws.amazon.com/net/post/Tx2C4MHH2H0SA5W/Enhancements-to-the-DynamoDB-SDK).](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DeclarativeTagsList.html)

Elemen ini dapat mencakup atribut berikut:

** `attribute` **  
Nama atribut untuk properti, seperti nama kunci rentang. Atribut ini memetakan ke `Amazon.Util.PropertyConfig.Attribute` properti di AWS SDK untuk .NET.

** `converter` **  
Jenis konverter yang harus digunakan untuk properti ini. Atribut ini memetakan ke `Amazon.Util.PropertyConfig.Converter` properti di AWS SDK untuk .NET.

** `ignore` **  
Apakah properti terkait harus diabaikan (true); jika tidak, false. Atribut ini memetakan ke `Amazon.Util.PropertyConfig.Ignore` properti di AWS SDK untuk .NET.

** `name` **  
Nama properti. Atribut ini memetakan ke `Amazon.Util.PropertyConfig.Name` properti di AWS SDK untuk .NET.

** `version` **  
Apakah properti ini harus menyimpan nomor versi item (true); jika tidak, false. Atribut ini memetakan ke `Amazon.Util.PropertyConfig.Version` properti di AWS SDK untuk .NET.

Induk `<property>` elemen adalah `<map>` elemen.

`<property>`Elemen tidak mengandung elemen anak.

Berikut ini adalah contoh `<property>` elemen yang digunakan:

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

#### proxy
<a name="net-dg-config-ref-elements-proxy"></a>

`<proxy>`Elemen mewakili pengaturan untuk mengkonfigurasi proxy AWS SDK untuk .NET untuk digunakan. Elemen ini dapat mencakup atribut berikut:

**host**  
Nama host atau alamat IP dari server proxy. Atribut ini memetakan ke `Amazon.Util.ProxyConfig.Host` `Amazon.AWSConfigs.ProxyConfig.Host` properti dari properti di AWS SDK untuk .NET.

**password**  
Kata sandi untuk mengautentikasi dengan server proxy. Atribut ini memetakan ke `Amazon.Util.ProxyConfig.Password` `Amazon.AWSConfigs.ProxyConfig.Password` properti dari properti di AWS SDK untuk .NET.

**port**  
Nomor port proxy. Atribut ini memetakan ke `Amazon.Util.ProxyConfig.Port` `Amazon.AWSConfigs.ProxyConfig.Port` properti dari properti di AWS SDK untuk .NET.

**nama pengguna**  
Nama pengguna untuk mengautentikasi dengan server proxy. Atribut ini memetakan ke `Amazon.Util.ProxyConfig.Username` `Amazon.AWSConfigs.ProxyConfig.Username` properti dari properti di AWS SDK untuk .NET.

Induk `<proxy>` elemen adalah `<aws>` elemen.

`<proxy>`Elemen tidak mengandung elemen anak.

Berikut ini adalah contoh `<proxy>` elemen yang digunakan:

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

#### s3
<a name="net-dg-config-ref-elements-s3"></a>

`<s3>`Elemen mewakili kumpulan pengaturan Amazon S3. Elemen ini dapat mencakup atribut *useSignatureVersion4*, yang menentukan apakah tanda tangan versi 4 penandatanganan akan digunakan untuk semua permintaan (true) atau apakah tanda tangan versi 4 penandatanganan tidak akan digunakan untuk semua permintaan (false, default). Atribut ini memetakan ke `Amazon.AWSConfigs.S3Config.UseSignatureVersion4` properti di AWS SDK untuk .NET.

Induk `<s3>` elemen adalah `<aws>` elemen.

`<s3>`Elemen tidak mengandung elemen anak.

Berikut ini adalah contoh `<s3>` elemen yang digunakan:

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