Il documento fornisce informazioni dettagliate sull'utilizzo di Amazon S3 tramite un client Perl, inclusi esempi di codice per operazioni come la creazione di bucket, l'aggiunta e la cancellazione di file, e la gestione delle chiavi. Viene inoltre trattata la configurazione delle autorizzazioni (ACL) e la gestione dei file in diverse 'directory' usando prefissi e delimitatori. La documentazione è rivolta a sviluppatori che desiderano integrare S3 nelle loro applicazioni Perl.

1. Amazon S3
Perl Web Client

2. ?

3. http://aws.amazon.com/s3/

4. Repository Repository Repository
Amazon S3
Client

5. Repository Repository Repository
? Amazon S3
Client

7. $

8. Repository Repository Repository
Amazon S3
Client

9. Repository Repository Repository
Amazon S3
HTTP
Client

10. Repository Repository Repository
Amazon S3
HTTP
Client

11. Repository Repository Repository
Amazon S3
HTTP
Client

12. Oggetto/File

13. Chiave => Valore

14. 1 byte - 5 Gbyte

15. 1 byte - 5 Gbyte

16. 1 byte - 5 Gbyte

17. 1 byte - 5 Gbyte
Non in scala!

18. Quanti ne volete

19. Bucket

20. Fino a 100

21. Nome Univoco

22. Net::Amazon::S3

23. ->new()
use Net::Amazon::S3;
my $s3 = Net::Amazon::S3->new({
aws_access_key_id => 'chiave-aws',
aws_secret_access_key => 'shhhh!',
retry => 1,
});

24. ->new()
use Net::Amazon::S3;
my $s3 = Net::Amazon::S3->new({
aws_access_key_id => 'chiave-aws',
aws_secret_access_key => 'shhhh!',
retry => 1,
});

25. ->new()
use Net::Amazon::S3;
my $s3 = Net::Amazon::S3->new({
aws_access_key_id => 'chiave-aws',
aws_secret_access_key => 'shhhh!',
retry => 1,
});
http://aws.amazon.com/s3/

27. retry

28. retry
secure

29. retry
secure
timeout

30. ->buckets()
my $buckets = $s3->buckets();
my $owner =
$buckets->{owner_displayname};
my $owner_id =
$buckets->{owner_id};
say "Bucket di $proprietario ",
"($owner_id):";

31. ->buckets()
my $aref = $buckets->{buckets};
for my $bucket (@$aref) {
my $nome = $bucket->bucket();
my $data = $bucket->creation_date();
say "t$nome, creato il $data";
}

32. ->add_bucket()
my $bucket = $s3->add_bucket({
bucket => ’foto-pippo’,
acl_short => ’public-read’,
# location_constraint => ’EU’,
});

33. ->add_bucket()
my $bucket = $s3->add_bucket({
bucket => ’foto-pippo’,
acl_short => ’public-read’,
# location_constraint => ’EU’,
});

34. ->add_bucket()
my $bucket = $s3->add_bucket({
bucket => ’foto-pippo’,
acl_short => ’public-read’,
# location_constraint => ’EU’,
});

35. ->add_bucket()
my $bucket = $s3->add_bucket({
bucket => ’foto-pippo’,
acl_short => ’public-read’,
# location_constraint => ’EU’,
});

36. Dice il Saggio:

37. “No Lettere Maiuscole!”

38. acl_short?

39. public-read

40. private
public-read

41. private
authenticated-read
public-read

42. private
authenticated-read
public-read
public-read-write

43. Eliminazione

44. Eliminazione
$s3->delete_bucket(
{bucket => ’buttami-via’});

45. Eliminazione
$s3->delete_bucket(
{bucket => ’buttami-via’});
$s3->delete_bucket($bucket);

46. Eliminazione
$s3->delete_bucket(
{bucket => ’buttami-via’});
$s3->delete_bucket($bucket);
$bucket->delete_bucket();

47. Ricordate: 100 bucket!

48. Chiavi

49. list_bucket()
my $risultato = $s3->list_bucket({
bucket => ’photo’,
});

51. Limiti

52. list_bucket()
my $risultato = $s3->list_bucket({
bucket => ’photo’,
max_keys => 100,
prefix => ’immagini/’,
delimiter => ’/’,
});

53. list_bucket()
my $risultato = $s3->list_bucket({
bucket => ’photo’,
max_keys => 100,
prefix => ’immagini/’,
delimiter => ’/’,
});

54. list_bucket()
my $risultato = $s3->list_bucket({
bucket => ’photo’,
max_keys => 100,
prefix => ’immagini/’,
delimiter => ’/’,
});

55. prefix
immagini/vacanze/IMG_0001.JPG
immagini/vacanze/IMG_0002.JGP
immagini/vacanze/IMG_0003.JGP
immagini/tizio.jpg
immagini/caio.png
lavoro/boh.pdf

56. list_bucket()
my $risultato = $s3->list_bucket({
bucket => ’photo’,
max_keys => 100,
prefix => ’immagini/’,
delimiter => ’/’,
});

57. prefix +
delimiter
immagini/vacanze/IMG_0001.JPG
immagini/vacanze/IMG_0002.JGP
immagini/vacanze/IMG_0003.JGP
immagini/tizio.jpg
immagini/caio.png
lavoro/boh.pdf

58. risultato
immagini/vacanze
immagini/tizio.jpg
immagini/caio.png

59. risultato
prefisso
“comune”!
immagini/vacanze
immagini/tizio.jpg
immagini/caio.png

60. marker

61. lista di una “directory”
my %ricerca = (
bucket => ’photo’,
prefix => ’immagini/’,
delimiter => ’/’,
);

62. lista di una “directory”
while (1) {
my $risultato = $s3->list_bucket(%ricerca)
or die ’errore’;
say "dir : $_" for @{ $risultato->{common_prefixes} };
say "file: $_->{key}" for @{ $risultato->{keys} };
last unless $risultato->{is_truncated};
$impostazioni_ricerca{marker} =
$risultato->{next_marker};
}

63. lista di una “directory”
while (1) {
my $risultato = $s3->list_bucket(%ricerca)
or die ’errore’;
say "dir : $_" for @{ $risultato->{common_prefixes} };
say "file: $_->{key}" for @{ $risultato->{keys} };
last unless $risultato->{is_truncated};
$impostazioni_ricerca{marker} =
$risultato->{next_marker};
}

64. lista di una “directory”
while (1) {
my $risultato = $s3->list_bucket(%ricerca)
or die ’errore’;
say "dir : $_" for @{ $risultato->{common_prefixes} };
say "file: $_->{key}" for @{ $risultato->{keys} };
last unless $risultato->{is_truncated};
$impostazioni_ricerca{marker} =
$risultato->{next_marker};
}

65. lista di una “directory”
while (1) {
my $risultato = $s3->list_bucket(%ricerca)
or die ’errore’;
say "dir : $_" for @{ $risultato->{common_prefixes} };
say "file: $_->{key}" for @{ $risultato->{keys} };
last unless $risultato->{is_truncated};
$impostazioni_ricerca{marker} =
$risultato->{next_marker};
}

66. lista di una “directory”
while (1) {
my $risultato = $s3->list_bucket(%ricerca)
or die ’errore’;
say "dir : $_" for @{ $risultato->{common_prefixes} };
say "file: $_->{key}" for @{ $risultato->{keys} };
last unless $risultato->{is_truncated};
$impostazioni_ricerca{marker} =
$risultato->{next_marker};
}

67. lista di una “directory”
while (1) {
my $risultato = $s3->list_bucket(%ricerca)
or die ’errore’;
say "dir : $_" for @{ $risultato->{common_prefixes} };
say "file: $_->{key}" for @{ $risultato->{keys} };
last unless $risultato->{is_truncated};
$impostazioni_ricerca{marker} =
$risultato->{next_marker};
}

68. Perl, baby

69. lista di una “directory”
my $risultato = $s3->list_bucket_all({
bucket => ’photo’,
prefix => ’immagini/’,
delimiter => ’/’,
});
say "dir : $_"
for @{ $risultato->{common_prefixes} };
say "file: $_->{key}"
for @{ $risultato->{keys} };

70. Oggetti, finalmente!

71. Aggiunta
my $bucket =
$s3->bucket(’bucket-lavoro’);
$bucket->add_key(’un/file/allegro‘
=> "Ciao a tutti!n");

72. Aggiunta
$bucket->add_key(chiave => ‘valore!’,
{
content_type => ’text/plain’,
acl_short => ’public-read’,
’x-amz-meta-info’ => ’baz!!!’,
}
);

73. Aggiunta
$bucket->add_key_filename(
‘mio/file.txt’,
‘/path/to/file.txt’,
)

74. Download
my $bucket =
$s3->bucket(’il-mio-bucket’);
my $dati =
$bucket->get_key(’un/file/allegro’);

75. Download
my $bucket =
$s3->bucket(’il-mio-bucket’);
my $dati =
$bucket->get_key(’un/file/allegro’);

76. Download
$dati = {
content_type => ‘text/plain’,
etag => ‘44b6...f367’,
content => “Ciao a tutti!n”,
# ...
};

77. Download
my $bucket =
$s3->bucket(’il-mio-bucket’);
my $dati =
$bucket->get_key_filename(
’un/file/allegro’, undef,
‘/salvalo/qui’);

78. Download
per eccellenza

79. public_read
public_read_write

80. http://
bucket.s3.amazonaws.com/
chiave

81. http://
polettix.s3.amazonaws.com/
tmp/pwc.tar.gz

82. Net::Amazon::S3::ACL

83. Attori

84. Attori
• proprietario

85. Attori
• proprietario
• altro utente Amazon S3

86. Attori
• proprietario
• altro utente Amazon S3
• tutti gli utenti Amazon S3

87. Attori
• proprietario
• altro utente Amazon S3
• tutti gli utenti Amazon S3
• tutti

88. Diritti

89. Diritti
• lettura

90. Diritti
• lettura
• scrittura

91. Diritti
• lettura
• scrittura
• lettura ACP

92. Diritti
• lettura
• scrittura
• lettura ACP
• scrittura ACP

93. Diritti
• lettura
• scrittura
• lettura ACP
• scrittura ACP
• controllo completo

94. N::A::S::ACL
use Net::Amazon::S3::ACL;
my $acl =
Net::Amazon::S3::ACL->new();
my $acl_xml =
$bucket->get_acl(’etc/passwd’);
$acl->parse($acl_xml);
say $acl->stringify(); # XML
say $acl->dump(); # YAML, se presente

95. ->add()
$acl->add(
’foo@example.com’ => ’WRITE’,
ALL => ’READ’,
’dfadffadf...‘ => ’*’,
);

96. set_acl()
$bucket->set_acl({
key => $chiave,
acl_xml => $acl->stringify(),
});

97. Upload da esterni

98. Net::Amazon::S3::Policy

99. F M
Net::Amazon::S3::Policy
T
R

100. F M
Net::Amazon::S3::Policy
T
R
Friendly

101. ?

102. !